Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

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

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
Example:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-08-13"

Body

application/json
account_id
string

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

Example:

"biz_xxxxxxxxxxxxxx"

assigned_user_id
string

The account member (a user_ identifier) to assign the card to. Required for business card issuing accounts.

Example:

"user_xxxxxxxxxxxxxx"

name
string

A display name for the card.

Example:

"Detailer card"

spend_limit
number

Spending limit amount, in dollars.

Example:

500

spend_limit_frequency
enum<string>

The window the spend limit applies to.

Available options:
daily,
weekly,
monthly,
one_time
Example:

"weekly"

transaction_limit
number

Per-transaction limit amount, in dollars.

Example:

200

user_id
string

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

Example:

"user_xxxxxxxxxxxxxx"

Response

card created

billing
object | null
required

The billing address.

canceled_at
string<date-time> | null
required

When the card was canceled.

created_at
string<date-time> | null
required

When the card was created.

Example:

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

expiration_month
string | null
required

Card expiration month.

Example:

"12"

expiration_year
string | null
required

Card expiration year.

Example:

"2030"

id
string
required

Card ID, prefixed icrd_.

Example:

"icrd_xxxxxxxxxxxxxx"

last4
string | null
required

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

Example:

"4242"

limit
object | null
required

The spending limit configuration.

name
string | null
required

Card display name.

Example:

"Detailing supplies"

object
enum<string>
required
Available options:
card
Example:

"card"

spent_last_month
integer | null
required

Total spend in the last 30 days, in cents.

Example:

0

status
enum<string> | null
required

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

Available options:
null,
active,
frozen,
canceled,
invited,
denied
Example:

"active"

type
enum<string> | null
required

The card type.

Available options:
null,
virtual,
physical
Example:

"virtual"

user_id
string | null
required

Cardholder user ID, prefixed user_, when assigned.

Example:

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