Skip to main content
POST

Authorizations

Authorization
string
header
required

Short-lived access token. Obtain with your api_key.

Headers

Idempotency-Key
string<uuid>
required

A UUID you generate per order. Retrying with the same key returns the original result.

Path Parameters

id
string<uuid>
required

Card UUID.

Body

application/json
reason
enum<string>
required
Available options:
lost,
fraud

Response

The card.

A company card. Card numbers, CVVs, and PINs are never returned.

id
string<uuid>
required
token
string
required

Card token, a string of digits. Usable in the tokens list filter.

company_id
string<uuid>
required
account_id
string<uuid>
required

Account the card spends from.

user_id
string<uuid>
required

Cardholder.

type
enum<string>
required
Available options:
virtual,
physical
design_id
string<uuid>
required
status
enum<string>
required

inactive cards are issued but not yet activated. suspended, locked, and blocked are set by Incard. expired and terminated cards have ended.

Available options:
inactive,
active,
frozen,
suspended,
locked,
blocked,
expired,
terminated
name
string
required
last_four
string
required
expiry_date
string<date>
required
auto_convert
boolean
required
three_ds_biometric
boolean
required
spending_limit
CardSpendingLimit · object | null
required

The card's spending limit, or null for none.

card_limits
CardLimits · object
required

Fixed limits on the card, in EUR. used is only included in list responses.

created_at
string<date-time>
required