Update a card's status and limit
Freezes, unfreezes or blocks a card, and sets its daily limit. Always send limit with status. A call without limit sets the limit to 0, which stops a live card from spending. To change only the limit, send the current status with the new limit.
blocked is permanent. Allowed changes are active to freeze or blocked, freeze to active or blocked, and inactive to active or blocked. Gravv sends the cards.status.update webhook when the status changes. This route needs no Idempotency-Key.
Path Parameters
ID of the card
Request Body
Possible values: active, freeze, blocked
Daily limit in whole USD. Send it on every call.
Request Examples
{
"status": "freeze",
"limit": 200
}
{
"status": "active",
"limit": 200
}
{
"status": "blocked",
"limit": 200
}
Responses
| Status | Description |
|---|---|
200 |
The updated card |
400 |
Invalid status or limit, a blocked card, or a change that is not allowed |
200 response
******* and the last 4 digits
MM/YYYY. Sandbox cards show YYYY-MM-DD, so parse both. Empty when not known.
Possible values: virtual, physical
active can spend. freeze is a temporary hold. blocked is permanent. inactive is issued but not yet activated. An empty value is an application with no card yet.
Possible values: active, freeze, blocked, inactive, ``
One of the following variants:
Required for a physical card. address_line2 is not read.
Send it as a string, so leading zeros are kept
Alpha-2 code
Possible values: standard, express, international, apc, uspsInternational, overnight
- null (
null)
Possible values: virtual, physical
The card's spending limit, in whole USD per day
400 response
What went wrong
{
"data": null,
"error": "card is blocked and cannot be updated"
}
Authorization
- ApiKeyAuth