GET
/
v3
/
wallets
/
{cardId}
Get Wallet Card
curl --request GET \
  --url https://sandbox-api.cardcash.com/v3/v3/wallets/{cardId} \
  --header 'Authorization: Bearer <token>'

Overview

Returns full details for a specific wallet card, including merchant info, barcode format, claims, and masked card data.

Request

Path Parameters

ParameterTypeRequiredDescription
cardIdintegerYesWallet card ID
curl https://sandbox-api.cardcash.com/v3/wallets/789 \
  -H "x-cc-app: YOUR_APP_ID" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

{
  "id": 789,
  "internalCardId": 56789,
  "merchant": {
    "id": 123,
    "name": "Target",
    "balanceCheckLink": "https://www.target.com/gift-card-balance",
    "color": "#CC0000",
    "description": "Target gift cards...",
    "buyMessage": "Digital delivery within minutes",
    "image": "https://cdn.cardcash.com/merchants/target.png",
    "barcode": {
      "format": "CODE128",
      "contents": "6006491234567890"
    }
  },
  "order": {
    "id": "order-uuid",
    "orderNum": 12345,
    "datePurchased": "2026-01-15T12:00:00.000Z"
  },
  "amount": {
    "balance": 50.00,
    "cost": 45.75,
    "currentBalance": 50.00
  },
  "discounts": {
    "coupon": false,
    "paymentMethodDiscount": 0
  },
  "type": "ecode",
  "number": "****7890",
  "pin": "****",
  "prefix": "600649",
  "status": "active",
  "numberIsMasked": true,
  "canNGCBalanceInquiry": false,
  "claims": []
}

Response Fields

FieldTypeDescription
idintegerWallet card ID
merchant.balanceCheckLinkstringURL to check balance on merchant site
merchant.barcode.formatstringBarcode format (CODE128, EAN13, etc.)
merchant.barcode.contentsstringBarcode content string
amount.balancenumberOriginal face value
amount.costnumberPrice paid
amount.currentBalancenumberCurrent balance
numberstringCard number (masked unless verified)
pinstringPIN (masked unless verified)
prefixstringBarcode prefix for this merchant
statusstring"active" or "spent"
numberIsMaskedbooleanWhether number/pin are masked
canNGCBalanceInquirybooleanWhether auto-balance check is available
claimsarrayFiled claims for this card

Claim Object

FieldTypeDescription
idintegerClaim ID
amountnumberClaimed amount
datestringClaim date
statusstringClaim status
typestringClaim type name

Notes

  • Card number and PIN are masked by default. Use Get Secure Data to retrieve unmasked values
  • The barcode object provides what’s needed to render a scannable barcode
  • balanceCheckLink points to the merchant’s own balance check page