Skip to main content
GET
/
api
/
v1
/
cards
/
{id}
curl -X GET https://api.uncash.io/api/v1/cards/123 \
  -H "Authorization: Bearer uc_your_api_token_here"
{
  "success": true,
  "data": {
    "id": "123",
    "created_at": "2025-01-15T10:30:45.123Z",
    "updated_at": "2025-06-20T16:45:30.789Z",
    "PAN": "1234567812345678",
    "EXP": "12/30",
    "CVV": "123",
    "masked_PAN": "1234 56•• •••• 5678",
    "name": "My Business Card",
    "balance": 100,
    "deposit": 4500.5,
    "withdraw": 1200.75,
    "spent": 3300.25,
    "status": "Active",
    "currency": "USD",
    "currency_short_name": "USD",
    "category": "Business",
    "bin_id": "67ee33445566778899aabbcc",
    "3ds": true,
    "auto_topup": {
      "enabled": true,
      "min_balance": 10.00,
      "topup_amount": 50.00,
      "last_triggered": "2025-08-15T14:30:00.000Z"
    }
  },
  "message": "Card details retrieved successfully"
}

Path Parameters

id
string
required
The card ID to retrieve details for

Response

success
boolean
Indicates if the request was successful
data
object
message
string
Success message
curl -X GET https://api.uncash.io/api/v1/cards/123 \
  -H "Authorization: Bearer uc_your_api_token_here"
{
  "success": true,
  "data": {
    "id": "123",
    "created_at": "2025-01-15T10:30:45.123Z",
    "updated_at": "2025-06-20T16:45:30.789Z",
    "PAN": "1234567812345678",
    "EXP": "12/30",
    "CVV": "123",
    "masked_PAN": "1234 56•• •••• 5678",
    "name": "My Business Card",
    "balance": 100,
    "deposit": 4500.5,
    "withdraw": 1200.75,
    "spent": 3300.25,
    "status": "Active",
    "currency": "USD",
    "currency_short_name": "USD",
    "category": "Business",
    "bin_id": "67ee33445566778899aabbcc",
    "3ds": true,
    "auto_topup": {
      "enabled": true,
      "min_balance": 10.00,
      "topup_amount": 50.00,
      "last_triggered": "2025-08-15T14:30:00.000Z"
    }
  },
  "message": "Card details retrieved successfully"
}
Sensitive Data: This endpoint returns sensitive card information including PAN and CVV. Only use this for legitimate card operations and ensure secure handling of the response data.

Error Responses

{
  "success": false,
  "message": "Card not found or access denied",
  "timestamp": "2025-08-03T10:00:00.000Z"
}