Manage card status

After creating a card, you can manage its status using the Update card status endpoint. Card status controls whether you can use the card for transactions.

The card status values can be one of the following:

StatusDescription
activecard is active, and you can use it for transactions
freezecard is temporarily frozen, and you can't use it until it's reactivated
blockedcard is permanently blocked, and you can't reactivate it

For example, to temporarily freeze a card, set the status field to freeze in the request body:

curl --request PATCH \
     --url https://api.gravv.xyz/v1/cards/<card id>/update \
     --header 'Api-Key: <Api Key>' \
     --header 'content-type: application/json' \
     --data '
{
  "status": "freeze"
}
'