Skip to main content
POST
Create card
Issues a virtual debit card on a bank account, with the spending limits you specify. The card’s authorization_controls.usage.category must be multi_use, and at least one limit is required. Every limit matching a payment is checked and the most restrictive one applies, so a payment is declined once it exceeds the per-transaction cap, or once the day’s spend would pass the daily cap, even while the weekly and monthly caps still have room. Card payments will be rejected when there’s insufficient balance on the bank account regardless of the limits you set.

Headers

string
required
A key that prevents issuing a duplicate card if the same request is retried. Reusing a key returns the originally created card instead of issuing a second one. See Idempotency.

Request body

string
required
The bank account this card draws from.
string
required
A human-readable label for this card. Between 1 and 50 characters.
object
required
Controls that restrict how this card can be used.

Response

Returns the created card object.
string
Unique identifier for the card, prefixed with card_.
string
ISO 8601 timestamp of when the card was created.
string
The ID of the entity that owns this card.
string
The bank account this card draws from.
string | null
The human-readable label for this card.
string
The last 4 digits of the card number.
enum
The card’s status.
object
Every control restricting how this card can be used, including the ones Lemma applies to every card it issues.