Skip to main content
Use the Cards API to issue cards, list cards for an account or user, retrieve active card details such as the card number and CVC, and list the transactions made with them.

​
Endpoints

​
Attributes

​
string
required
Card ID, prefixed icrd_.
​
object | null
required
The billing address.

Properties

​
string | null
required
Billing city.
​
string | null
required
Billing country code.
​
string | null
required
Street address line 1.
​
string | null
required
Street address line 2.
​
string | null
required
Billing postal code.
​
string | null
required
Billing region or state.
​
string | null
required
When the card was canceled.
​
string | null
required
When the card was created.
​
string[] | null
required
The digital wallets the card has been added to. List Cards, Update Card, and webhook payloads return null, as does Retrieve Card when the wallets cannot be retrieved.Available options: apple_pay, google_pay
​
string | null
required
Card expiration month.
​
string | null
required
Card expiration year.
​
boolean
required
true once the issuer has issued the card. false for an invited card still waiting on its cardholder’s onboarding or review, or one the issuer declined; it has no card number until it is issued.
​
string | null
required
Last four digits of the card number. null for pending invitation cards.
​
object | null
required
The spending limit configuration.

Properties

​
number
required
The limit amount in dollars.
​
string
required
The window the limit amount applies to. per_transaction caps each individual authorization and is what a limit set with transaction_limit reports.Available options: daily, weekly, monthly, one_time, per_transaction
​
string | null
required
Card display name.
​
string
required
​
object | null
Sensitive card details. Present only on GET /cards/:id for active cards; null when the card is inactive or details cannot be retrieved.

Properties

​
string
required
Full card number.
​
string
required
Card verification code.
​
string | null
required
Cardholder name printed on the card.
​
string | null
required
The card PIN. Only returned when the request is authenticated as the user the card is assigned to; null for all other callers, including account API keys.
​
integer | null
required
Total spend in the last 30 days, in cents.
​
string | null
required
The card status. denied means the issuer declined the cardholder, so the card will never be issued.Available options: active, frozen, canceled, invited, denied
​
string | null
required
The card type.Available options: virtual, physical
​
string | null
required
Cardholder user ID, prefixed user_, when assigned.
Card