{
"id": "3f8b2c1d-9e4a-4b7c-8d2e-1f3a5b7c9d0e",
"token": "104857321",
"company_id": "bebb185d-8210-4e66-ac63-397b49a1e09f",
"account_id": "0d6c0a2a-2b08-49bc-89a9-eb936c9ff28c",
"user_id": "29b297ca-c617-437e-9c1d-32f494fbf44d",
"type": "virtual",
"design_id": "c6d5ea1a-80f8-49ab-9fee-250d368b3915",
"status": "frozen",
"name": "Marketing spend",
"last_four": "4242",
"expiry_date": "2029-07-31",
"auto_convert": false,
"three_ds_biometric": false,
"spending_limit": {
"period": "monthly",
"amount": "5000.00",
"currency": "GBP",
"used": "1249.50"
},
"card_limits": {
"currency": "EUR",
"max_per_purchase": {
"amount": "250000.00"
},
"daily": {
"amount": "500000.00"
},
"rolling_32_days": {
"amount": "2500000.00"
}
},
"created_at": "2026-07-01T08:30:00Z"
}{
"error": "invalid spending limit: amount has more than 2 decimal places"
}{
"success": false,
"error": {
"code": "forbidden",
"message": "access denied"
}
}{
"error": "card not found"
}{
"error": "invalid status change: card is inactive, cannot make it frozen"
}{
"error": "card issuer rejected the request"
}{
"error": "card issuer unavailable"
}{
"error": "card issuer unavailable"
}Change card status
Freezes (active → frozen), unfreezes (frozen → active), activates (inactive → active), or permanently
terminates a card (any live status → terminated). Setting the status a card already has succeeds without change.
Requires permission manage_cards.
{
"id": "3f8b2c1d-9e4a-4b7c-8d2e-1f3a5b7c9d0e",
"token": "104857321",
"company_id": "bebb185d-8210-4e66-ac63-397b49a1e09f",
"account_id": "0d6c0a2a-2b08-49bc-89a9-eb936c9ff28c",
"user_id": "29b297ca-c617-437e-9c1d-32f494fbf44d",
"type": "virtual",
"design_id": "c6d5ea1a-80f8-49ab-9fee-250d368b3915",
"status": "frozen",
"name": "Marketing spend",
"last_four": "4242",
"expiry_date": "2029-07-31",
"auto_convert": false,
"three_ds_biometric": false,
"spending_limit": {
"period": "monthly",
"amount": "5000.00",
"currency": "GBP",
"used": "1249.50"
},
"card_limits": {
"currency": "EUR",
"max_per_purchase": {
"amount": "250000.00"
},
"daily": {
"amount": "500000.00"
},
"rolling_32_days": {
"amount": "2500000.00"
}
},
"created_at": "2026-07-01T08:30:00Z"
}{
"error": "invalid spending limit: amount has more than 2 decimal places"
}{
"success": false,
"error": {
"code": "forbidden",
"message": "access denied"
}
}{
"error": "card not found"
}{
"error": "invalid status change: card is inactive, cannot make it frozen"
}{
"error": "card issuer rejected the request"
}{
"error": "card issuer unavailable"
}{
"error": "card issuer unavailable"
}Authorizations
Short-lived access token. Obtain with your api_key.
Path Parameters
Card UUID.
Body
active, frozen, terminated Response
The card.
A company card. Card numbers, CVVs, and PINs are never returned.
Card token, a string of digits. Usable in the tokens list filter.
Account the card spends from.
Cardholder.
virtual, physical inactive cards are issued but not yet activated. suspended, locked, and blocked are set by Incard.
expired and terminated cards have ended.
inactive, active, frozen, suspended, locked, blocked, expired, terminated The card's spending limit, or null for none.
Show child attributes
Show child attributes
Fixed limits on the card, in EUR. used is only included in list responses.
Show child attributes
Show child attributes