Get Card Details

Get detailed information about a specific card (non-sensitive data only)

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

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The card ID (UUID) to retrieve details for

Response

Success Response

Field	Type	Description
success	boolean	Indicates if the request was successful
message	string	Success message
timestamp	string	ISO 8601 timestamp

Data Object

Field	Type	Description
id	string	Database card ID (UUID)
created_at	string	ISO 8601 timestamp
updated_at	string	ISO 8601 timestamp
category	string	Card category ("Wallet" or "Online")
masked_PAN	string	Masked card number (e.g., "**** **** **** 1249")
name	string	Card nickname
balance	number	Current card balance
deposit	number	Total deposits made to card
status	string	Card status ("active", "frozen", "closed")
currency	string	Card currency (e.g., "USD")
currency_short_name	string	Currency abbreviation
bin_id	string	Associated BIN ID
3ds	boolean	3D Secure enabled

Request Example

cURL

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

JavaScript

const response = await fetch('https://api.uncash.io/api/v1/cards/card-id', {
  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"
headers = {"Authorization": "Bearer uc_your_api_token_here"}

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

Response Example

{
  "success": true,
  "message": "Card details retrieved successfully",
  "data": {
    "id": "card-id",
    "created_at": "2025-11-22T08:26:48.998433+00:00",
    "updated_at": "2025-11-22T08:27:06.96029+00:00",
    "category": "Wallet",
    "masked_PAN": "**** **** **** 1234",
    "name": "card-name",
    "balance": 10,
    "deposit": 10,
    "status": "active",
    "currency": "USD",
    "currency_short_name": "USD",
    "bin_id": "bin-id",
    "3ds": true
  },
  "timestamp": "2025-11-22T09:27:01.970Z"
}

Notes

Sensitive Data: For sensitive card information (PAN, CVV, EXP), use the /api/v1/cards/{id}/details endpoint.

Error Responses

Card Not Found

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

Invalid Card ID

{
  "success": false,
  "message": "Card ID is required",
  "timestamp": "2025-11-22T10:00:00.000Z"
}