List Cards

Get all user's virtual cards with summary information

Endpoint: GET https://api.uncash.io/api/v1/cards

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
total_balance	number	Total balance across all cards
total_cards	number	Total number of cards
cards	array	Array of card objects

Card Object

Field	Type	Description
id	string	Card ID (UUID)
name	string	Card nickname
status	string	Card status ("active", "frozen", "closed")
balance	number	Current card balance
category	string	Card category ("wallet" or "online")
card_plan	number	Card plan ID
card_number	string	Masked card number (e.g., "************1249")
created_at	string	ISO 8601 timestamp

Request Example

cURL

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

JavaScript

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

const data = await response.json();

Python

import requests

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

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

Response Example

{
  "success": true,
  "message": "User cards retrieved successfully",
  "data": {
    "total_balance": 2140.15,
    "total_cards": 41,
    "cards": [
      {
        "id": "card-id",
        "name": "card-name",
        "status": "active",
        "balance": 10,
        "category": "wallet",
        "card_plan": 1,
        "card_number": "************1234",
        "created_at": "2025-11-22T08:26:48.998433+00:00"
      }
    ]
  },
  "timestamp": "2025-11-22T09:27:01.970Z"
}