Skip to main content
GET
Get card

Authorizations

x-contro-api-key
string
header
required

Partner API key (sk_live_* for production, sk_test_* for sandbox)

Path Parameters

id
string
required

Card ID

Example:

"card_def456"

Response

Card details

id
string
required

Card ID

Example:

"card_def456"

type
string
required

Card type. One of: virtual, physical

Example:

"virtual"

brand
string
required

Card network brand. One of: Visa, Mastercard

Example:

"Visa"

status
string
required

Current card status. One of: created, active, frozen, cancelled

Example:

"active"

nameOnCard
string | null
required

Name embossed on the card, or null for virtual cards

Example:

"JANE DOE"

limit
number | null
required
deprecated

Deprecated. Mirrors spendControl.sales.allTime. Use spendControl for per-transaction-type velocity caps.

Example:

5000

last4
string | null
required

Last 4 digits of the card number

Example:

"0000"

programId
string | null
required

Card program this card was issued from

Example:

"prog_xyz"

createdAt
string
required

ISO 8601 creation timestamp

Example:

"2026-03-20T14:30:00Z"

spendControl
object | null

Per-transaction-type velocity caps and accrued spend. null/omit = no caps.