{
"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": "card is being changed; try again"
}{
"error": "card issuer rejected the request"
}{
"error": "card issuer unavailable"
}{
"error": "card issuer unavailable"
}Update card
Changes one or more of a card’s settings. Send at least one field.
Moving a card that has a spending limit to an account in another currency also needs a new spending_limit in that currency.
expired and terminated cards can only be renamed. An account_id the member can’t access returns 404 account not found.
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": "card is being changed; try again"
}{
"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
New card name. Must not be empty.
Account the card spends from.
Periods follow the UK calendar; weeks start on Monday. amount must be more than 0 and have at most two decimal places.
A daily limit can be at most card_limits.daily.amount, and a weekly or monthly limit at most
card_limits.rolling_32_days.amount, compared as-is without converting from EUR. lifetime limits have no cap.
Show child attributes
Show child attributes
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