Sign in

v8

OpenAPI 3.1.02026-08-033623795.0 MB
Cards

Create Card

Issue a virtual card, or apply for card issuing.

post/cards

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

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

Request body

account_idstring

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

assigned_user_idstring

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

namestring

A display name for the card.

spend_limitnumber

Spending limit amount, in dollars.

spend_limit_frequency'daily' | 'weekly' | 'monthly' | 'one_time'

The window the spend limit applies to.

transaction_limitnumber

Per-transaction limit amount, in dollars.

user_idstring

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

Response

card created

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' nullable required

The card status.

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

The card type.

user_idstring nullable required

Cardholder user ID, prefixed user_, when assigned.