---
title: "List cards"
method: GET
path: "/cards"
---

# List cards

`GET /cards`

List cards.

## Query parameters

- `payerId` string, required
- `limit` integer
- `offset` integer

## Response `200`

Returns a paginated list of cards

- object
  - `data` Card[], required — The list of cards for this page.
    - `bin` string, required — The first 8 digits of the card number.
    - `last4` string, required — The last 4 digits of the card number.
    - `expiry` object, required
      - `month` string, required — The expiry month of the card in MM format (01-12).
      - `year` string, required — The expiry year of the card in YY format (e.g., 25 for 2025).
    - `network` 'visa' | 'mastercard' | 'amex' | 'diners' — The network of the card.
    - `fundingType` 'credit' | 'debit' | 'prepaid' — The funding type of the card.
    - `issuer` object
      - `name` string — The name of the financial institution that issued the card.
      - `country` string — The country code (ISO 3166-1 alpha-2) of the card issuer (e.g., "ZA" for South Africa).
    - `id` string, required — The unique identifier for this card.
    - `createdAt` string, date-time, required — The UTC timestamp indicating when the card was created. Formatted as an ISO 8601 string (e.g., 2024-01-15T09:30:00Z).
    - `updatedAt` string, date-time — The UTC timestamp indicating when the card was last modified. Formatted as an ISO 8601 string (e.g., 2024-01-15T09:35:00Z).
  - `page` object, required — Pagination information for this response.
    - `limit` integer, required — The limit used for this response.
    - `offset` integer, required — The offset used for this response.
    - `hasNext` boolean, required — Whether there is a next page for this response.

---

[API](https://skmtc.dev/stitch/apis/stitch-api.md) · [All operations](https://skmtc.dev/stitch/apis/stitch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stitch/stitch-api/revisions/8c5a258567d0/schema)