---
title: "List cards"
method: GET
path: "/card/list/{customerId}"
tags: ["Card"]
---

# List cards

`GET /card/list/{customerId}`

Retrieve all card information for the given `customerId`.

## Path parameters

- `customerId` CardId, required — unresolved $ref

## Query parameters

- `status` 'Default' | 'All' | 'Archived' | 'Denied' | 'Expired' | 'Hotlisted' | 'Initiated' | 'Pending' | 'PendingVerification' | 'Reissued' | 'ReissuedPendingVerification' | 'AutoReissuedPendingVerification' | 'Verified' — Specify a single card status to be returned. Only one value can be passed. `Default` includes `Archived`, `Denied`, `Expired`, `Hotlisted`, `Initiated`, `Pending`, `PendingVerification`, `Reissued`, `ReissuedPendingVerification`, `AutoReissuedPendingVerification` and `Verified`

## Response `200`

An array of <a href="https://docs.helix.q2.com/docs/card" target="_blank">card</a> objects

- CardArray200Response
  - `errors` unknown[]
    - unknown
  - `requestId` string
  - `status` 200
  - `throttle` object
    - `periodEndsAt` LastContactDate — unresolved $ref
    - `periodLengthInSeconds` integer
    - `periodRequestLimit` integer
    - `requestsRemainingInPeriod` integer
    - `warningThreshold` number
  - `data` Data[] — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `404` — unresolved $ref
- `405` — unresolved $ref
- `429` — unresolved $ref

---

[API](https://skmtc.net/q2/apis/helix-api.md) · [All operations](https://skmtc.net/q2/apis/helix-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/q2/helix-api/revisions/0f8d32b907b3/schema)