Get Card List

Retrieves a paginated list of cards for the authenticated user.

Endpoint: GET /list

Query Parameters:

Parameter	Type	Required	Description
limit	Number	Yes	Maximum number of cards to return (max 100)
offset	Number	Yes	Number of cards to skip for pagination (0-based)

Response:

{
  "count": 25,
  "cards": [
    {
      "created": "2026-01-15T10:30:00.000Z",
      "blocked": "2025-07-04T12:33:05.916Z",
      "san": "1234567890",
      "pan": "************7527",
      "expyear": 2026,
      "expmonth": 12,
      "currency": "USD",
      "cardsystem": "VISA",
      "cardname": "My Card"
    },
    {
      "created": "2026-01-10T08:15:30.000Z",
      "san": "0987654321",
      "pan": "************2345",
      "expyear": 2027,
      "expmonth": 6,
      "currency": "EUR",
      "cardsystem": "MC",
      "cardName": "Business Card",
    }
  ]
}

Response Fields:

Field	Type	Description
count	Number	Total number of cards available (for pagination)
cards	Array	Array of card objects
cards[].san	String	Secure Account Number (unique card identifier)
cards[].created	String (ISO 8601)	Card creation timestamp in UTC
cards[].pan	String	Masked Card Number
cards[].expYear	Number	Card expiration year
cards[].expMonth	Number	Card expiration month (1-12)
cards[].currency	String	Card currency code (USD, EUR, etc.)
cards[].cardSystem	String	VISA, MC
cards[].cardName	String	User-defined card name
cards[].blocked	String (ISO 8601) or null	Card blocked timestamp in UTC