Skip to main content
PUT
/
cards
/
{id}
/
unfreeze
Unfreeze a card
curl --request PUT \
  --url https://api.cartevo.co/api/v1/cards/{id}/unfreeze \
  --header 'Authorization: Bearer <token>'

​
Overview

PUT /cards/{id}/unfreeze reactivates a card that was previously frozen via PUT /cards/{id}/freeze. The card’s balance is unchanged; it can authorize transactions again immediately on success. This action cannot unfreeze a card that has been TERMINATED — termination is permanent.

​
When to use it

  • The investigation that led you to freeze the card has cleared.
  • The cardholder has returned from leave and needs the card again.

​
Prerequisites

  • The card must belong to your company.
  • Card status must be FROZEN (not ACTIVE, TERMINATED, etc.).

​
Request

​
Headers

NameRequiredDescription
AuthorizationYesBearer <access_token>

​
Path parameters

NameTypeDescription
idstringCard ID (UUID).

​
Query parameters

NameTypeDefaultDescription
unlockbooleanfalseIf true, also undo the deeper “lock” applied with PUT /cards/{id}/freeze?lock=true. Set this only if you previously locked the card.

​
Body

None.

​
Response

​
200 — Success

{
  "success": true,
  "statusCode": 200,
  "message": "Card unfrozen successfully",
  "data": {
    "card_id": "550e8400-e29b-41d4-a716-446655440000",
    "card_status": "ACTIVE"
  }
}

​
Error responses

Statusmessage exampleTrigger
400"Card not frozen"Card status is not FROZEN.
400"Card terminated"Card is TERMINATED and cannot be reactivated.
404"Card not found"id is invalid or belongs to another company.

​
Webhooks fired

None today. Card status changes to ACTIVE immediately.

​
Code examples

cURL
curl -X PUT https://api.cartevo.co/api/v1/cards/550e8400-e29b-41d4-a716-446655440000/unfreeze \
  -H "Authorization: Bearer $TOKEN"
Node.js (axios)
await axios.put(
  `https://api.cartevo.co/api/v1/cards/${cardId}/unfreeze`,
  null,
  { headers: { Authorization: `Bearer ${token}` } }
);

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

Response

Card unfrozen successfully