Skip to main content
GET
TypeScript

Autorizaciones

Authorization
string
header
requerido

An Account API key, an App API key, an account access token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

payout:account:read

Encabezados

Api-Version-Date
string

Pins the request to a dated API version.

Ejemplo:

"2026-11-17"

Parámetros de ruta

id
string
requerido

Card ID to retrieve, prefixed icrd_.

Parámetros de consulta

account_id
string

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

user_id
string

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

Respuesta

card retrieved with its PIN by the assigned cardholder

billing
object | null
requerido

The billing address.

canceled_at
string<date-time> | null
requerido

When the card was canceled.

Ejemplo:

"2026-01-01T12:00:00.000Z"

created_at
string<date-time> | null
requerido

When the card was created.

Ejemplo:

"2026-01-01T12:00:00.000Z"

digital_wallets
enum<string>[] | null
requerido

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.

Opciones disponibles:
apple_pay,
google_pay
expiration_month
string | null
requerido

Card expiration month.

Ejemplo:

"12"

expiration_year
string | null
requerido

Card expiration year.

Ejemplo:

"2027"

id
string
requerido

Card ID, prefixed icrd_.

Ejemplo:

"icrd_xxxxxxxxxxxxxx"

issued
boolean
requerido

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.

Ejemplo:

true

last4
string | null
requerido

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

Ejemplo:

"4242"

limit
object | null
requerido

The spending limit configuration.

name
string | null
requerido

Card display name.

Ejemplo:

"Bay rent card"

object
enum<string>
requerido
Opciones disponibles:
card
Ejemplo:

"card"

spent_last_month
integer | null
requerido

Total spend in the last 30 days, in cents.

Ejemplo:

1234

status
enum<string> | null
requerido

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

Opciones disponibles:
null,
active,
frozen,
canceled,
invited,
denied
Ejemplo:

"active"

type
enum<string> | null
requerido

The card type.

Opciones disponibles:
null,
virtual,
physical
Ejemplo:

"virtual"

user_id
string | null
requerido

Cardholder user ID, prefixed user_, when assigned.

Ejemplo:

"user_xxxxxxxxxxxxxx"

secrets
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.