Create Card
Issue a virtual card, or apply for card issuing.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Pins the request to a dated API version.
"2026-08-13"
Body
The owning account ID (a biz_ identifier). Provide this or user_id.
"biz_xxxxxxxxxxxxxx"
The account member (a user_ identifier) to assign the card to. Required for business card issuing accounts.
"user_xxxxxxxxxxxxxx"
A display name for the card.
"Detailer card"
Spending limit amount, in dollars.
500
The window the spend limit applies to.
daily, weekly, monthly, one_time "weekly"
Per-transaction limit amount, in dollars.
200
The owning user ID (a user_ identifier). Provide this or account_id.
"user_xxxxxxxxxxxxxx"
Response
card created
The billing address.
When the card was canceled.
When the card was created.
"2026-01-01T12:00:00.000Z"
Card expiration month.
"12"
Card expiration year.
"2030"
Card ID, prefixed icrd_.
"icrd_xxxxxxxxxxxxxx"
Last four digits of the card number. null for pending invitation cards.
"4242"
The spending limit configuration.
Card display name.
"Detailing supplies"
card "card"
Total spend in the last 30 days, in cents.
0
The card status. denied means the issuer declined the cardholder, so the card will never be issued.
null, active, frozen, canceled, invited, denied "active"
The card type.
null, virtual, physical "virtual"
Cardholder user ID, prefixed user_, when assigned.
"user_xxxxxxxxxxxxxx"
Sensitive card details. Present only on GET /cards/:id for active cards; null when the card is inactive or details cannot be retrieved.

