{
"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 cannot be replaced: only virtual cards can be replaced"
}{
"error": "card issuer rejected the request"
}{
"error": "card issuer unavailable"
}{
"error": "card issuer unavailable"
}Replace card
Gives a virtual card a new number, token, last four, and expiry date. Its id, status, account, limits, and settings stay the same.
Spend towards its spending_limit starts again at zero on the new number.
Only active or frozen virtual cards can be replaced. Retrying with the same Idempotency-Key returns the replaced card.
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 cannot be replaced: only virtual cards can be replaced"
}{
"error": "card issuer rejected the request"
}{
"error": "card issuer unavailable"
}{
"error": "card issuer unavailable"
}Authorizations
Short-lived access token. Obtain with your api_key.
Headers
A UUID you generate per order. Retrying with the same key returns the original result.
Path Parameters
Card UUID.
Body
lost, fraud 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