GET
/
v3
/
wallets
List Wallet Cards
curl --request GET \
  --url https://sandbox-api.cardcash.com/v3/v3/wallets \
  --header 'Authorization: Bearer <token>'

​
Overview

Returns all purchased gift cards. Cards appear in the wallet once the order is fulfilled.

​
Request

​
Query Parameters

ParameterTypeRequiredDescription
archivedstringNoSet to "true" to include archived cards
curl https://sandbox-api.cardcash.com/v3/wallets \
  -H "x-cc-app: YOUR_APP_ID" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

{
  "cards": [
    {
      "id": 789,
      "order": {
        "id": "order-uuid",
        "orderNum": 12345,
        "datePurchased": "2026-01-15T12:00:00.000Z"
      },
      "merchant": {
        "id": 123,
        "name": "Target",
        "image": "https://cdn.cardcash.com/merchants/target.png"
      },
      "amount": {
        "balance": 50.00,
        "cost": 45.75,
        "currentBalance": 50.00
      },
      "type": "ecode",
      "numberLastFour": "7890",
      "status": "active"
    },
    {
      "id": 790,
      "order": {
        "id": "order-uuid-2",
        "orderNum": 12346,
        "datePurchased": "2026-01-10T09:30:00.000Z"
      },
      "merchant": {
        "id": 456,
        "name": "Amazon",
        "image": "https://cdn.cardcash.com/merchants/amazon.png"
      },
      "amount": {
        "balance": 100.00,
        "cost": 93.00,
        "currentBalance": 75.50
      },
      "type": "ecode",
      "numberLastFour": "4321",
      "status": "active"
    }
  ]
}

​
Response Fields

FieldTypeDescription
idintegerWallet card ID — use for detail/secure-data requests
order.idstringOrder UUID this card belongs to
order.orderNumintegerOrder number
order.datePurchasedstringISO 8601 purchase date
merchant.idintegerMerchant ID
merchant.namestringMerchant name
merchant.imagestringMerchant logo URL
amount.balancenumberOriginal face value
amount.costnumberPrice paid
amount.currentBalancenumberCurrent known balance
typestringCard type
numberLastFourstringLast 4 digits of card number
statusstring"active" or "spent"

​
Notes

  • Only fulfilled cards appear in the wallet
  • currentBalance may differ from balance if part of the card has been used and the balance was updated
  • By default, archived cards are excluded — add ?archived=true to include them
  • Use Get Secure Data to retrieve full card numbers and PINs
  • Retrieve secure data within 24 hours of purchase
  • A small number of new cards may be delivered as redemption URLs instead of card number and PIN — contact your account manager for details