Update card status

Update the status of a card. You can freeze a card temporarily or block it permanently.

Status Options:

active: Card is active, and you can use it for transactions
freeze: Card is temporarily frozen, and you can't use it until you reactivate it by updating the status to active
blocked: Card is permanently blocked, and you can't reactivate it

PATCH/v1/cards/{card_id}/update

Path Parameters

The ID of the card to update

New status for the card

Possible values: active, freeze, blocked

Optional spending limit for the card

{
"status": "freeze"
}

{
"status": "active"
}

{
"status": "blocked"
}

Status	Description
`200`	Card status updated successfully
`400`	Invalid request
`404`	Card not found

Blockchain asset associated with the card

Blockchain network of the card

Currency of the card

Card ID

Updated card status

Possible values: active, freeze, blocked

Timestamp when the card was created

Timestamp when the card status was updated

Card expiry date

Masked Primary Account Number of the card

Name printed on the card

Card network

Proxy address associated with the card

Always null for error responses

Human-readable error message

{
"data": null,
"error": {
"code": "INVALID_ARGUMENT",
"message": "Invalid status value. Must be one of: active, freeze, blocked",
"details": {}
}
}

Always null for error responses

Human-readable error message

{
"data": null,
"error": {
"code": "NOT_FOUND",
"message": "Card not found",
"details": {}
}
}

Was this page helpful?