> For the complete documentation index, see [llms.txt](https://docs.cardspro.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cardspro.com/api/cards/get-card-list.md).

# Get Card List

Retrieves a paginated list of cards for the authenticated user.

**Endpoint:** `GET /list`

**Query Parameters:**

<table><thead><tr><th width="120.3333740234375">Parameter</th><th width="114.5555419921875">Type</th><th width="108.1112060546875">Required</th><th width="403.8890380859375">Description</th></tr></thead><tbody><tr><td><code>limit</code></td><td>Number</td><td>Yes</td><td>Maximum number of cards to return (max 100)</td></tr><tr><td><code>offset</code></td><td>Number</td><td>Yes</td><td>Number of cards to skip for pagination (0-based)</td></tr></tbody></table>

**Response:**

```json
{
  "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:**

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