Unfreeze Card

Unfreeze a card to restore normal functionality

Endpoint: PATCH https://api.uncash.io/api/v1/cards/{id}/unfreeze

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The card ID (UUID) to unfreeze

Response

Success Response

Field	Type	Description
success	boolean	Indicates if the card was unfrozen successfully
message	string	Success message
timestamp	string	ISO 8601 timestamp

Data Object

Field	Type	Description
card_id	string	Card ID (UUID) that was unfrozen
status	string	New card status ("active")

Request Example

cURL

curl -X PATCH https://api.uncash.io/api/v1/cards/card-id/unfreeze \
  -H "Authorization: Bearer uc_your_api_token_here"

JavaScript

const response = await fetch('https://api.uncash.io/api/v1/cards/card-id/unfreeze', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer uc_your_api_token_here'
  }
});

const data = await response.json();

Python

import requests

url = "https://api.uncash.io/api/v1/cards/card-id/unfreeze"
headers = {"Authorization": "Bearer uc_your_api_token_here"}

response = requests.patch(url, headers=headers)
data = response.json()

Response Example

{
  "success": true,
  "message": "Card unfrozen successfully",
  "data": {
    "card_id": "card-id",
    "status": "active"
  },
  "timestamp": "2025-11-22T11:35:00.000Z"
}

Behavior

• Transaction Restore: Card transactions will be enabled again
• Balance Preserved: Card balance remains unchanged
• Provider Update: Unfreeze status is applied at the provider level
• Status Change: Card status changes from "frozen" to "active"

Notes

Security: Only unfreeze your card when you're confident it's safe to use again.

Validation Rules

• Card must be in "frozen" status
• Card must have a valid provider_id (not 'temp')

Error Responses

Not Frozen

{
  "success": false,
  "message": "Only frozen cards can be unfrozen",
  "timestamp": "2025-11-22T10:00:00.000Z"
}

Card Not Ready

{
  "success": false,
  "message": "Card is not ready for unfreeze operation",
  "timestamp": "2025-11-22T10:00:00.000Z"
}