Retrieve Card
Retrieve a single card.
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
Pins the request to a dated API version.
"2026-08-13"
Path Parameters
Card ID to retrieve, prefixed icrd_.
Query Parameters
The owning account ID (a biz_ identifier). Provide this or user_id.
The owning user ID (a user_ identifier). Provide this or account_id.
Response
card retrieved with its PIN by the assigned cardholder
The billing address.
When the card was canceled.
"2026-01-01T12:00:00.000Z"
When the card was created.
"2026-01-01T12:00:00.000Z"
Card expiration month.
"12"
Card expiration year.
"2027"
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.
"Bay rent card"
card "card"
Total spend in the last 30 days, in cents.
1234
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.

