Sign in
latestOpenAPI 3.1.02026-08-153864115.7 MB

c301132dbfd7

Cards

Retrieve Card

Retrieve a single card.

get/cards/{id}

Query parameters

account_idstring

The owning account ID (a biz_ identifier). Provide this or user_id.

user_idstring

The owning user ID (a user_ identifier). Provide this or account_id.

Response

card retrieved with its PIN by the assigned cardholder

canceled_atstring date-time nullable required

When the card was canceled.

created_atstring date-time nullable required

When the card was created.

expiration_monthstring nullable required

Card expiration month.

expiration_yearstring nullable required

Card expiration year.

idstring required

Card ID, prefixed icrd_.

last4string nullable required

Last four digits of the card number. null for pending invitation cards.

namestring nullable required

Card display name.

object'card' required
spent_last_monthinteger nullable required

Total spend in the last 30 days, in cents.

status'null' | 'active' | 'frozen' | 'canceled' | 'invited' | 'denied' nullable required

The card status. denied means the issuer declined the cardholder, so the card will never be issued.

type'null' | 'virtual' | 'physical' nullable required

The card type.

user_idstring nullable required

Cardholder user ID, prefixed user_, when assigned.

Example response

{
  "billing": {
    "city": "Austin",
    "country_code": "US",
    "line1": "4180 Burnet Rd",
    "line2": "Suite 210",
    "postal_code": "78756",
    "region": "TX"
  },
  "canceled_at": "2026-01-01T12:00:00.000Z",
  "created_at": "2026-01-01T12:00:00.000Z",
  "expiration_month": "12",
  "expiration_year": "2027",
  "id": "icrd_xxxxxxxxxxxxxx",
  "last4": "4242",
  "limit": {
    "amount": 50,
    "frequency": "daily"
  },
  "name": "Bay rent card",
  "object": "card",
  "secrets": {
    "card_number": "4242424242424242",
    "cvc": "123",
    "name_on_card": "Tanya Cole",
    "pin": "1234"
  },
  "spent_last_month": 1234,
  "status": "active",
  "type": "virtual",
  "user_id": "user_xxxxxxxxxxxxxx"
}