---
title: "List Cards"
method: GET
path: "/v2/cards/"
tags: ["cards"]
---

# List Cards

`GET /v2/cards/`

## Query parameters

- `customer` string
- `start` integer
- `limit` integer

## Response `200`

Successful Response

- CardOutList
  - `range` ResponseRange, required
    - `start` integer, required
    - `end` integer, required
    - `limit` integer, required
    - `count` integer, required
    - `has_more` boolean, required
  - `cards` CardOut[], required
    - `customer` string — Associated customer
    - `brand` string, required — Card brand
    - `country` string, required — Country of the card issuer
    - `created` string, date-time, required — Date of creation in Epoch timestamp
    - `exp_month` integer, required — Month in MM format
    - `exp_year` integer, required — Year expiration in YYYY format
    - `external_id` string — Unique id with unicity check
    - `funding` 'credit' | 'debit' | 'prepaid' | 'universal' | 'charge' | 'deferred' | 'unknown' — An enumeration.
    - `id` string, required
    - `last4` string, required — Last 4 digit of the card number
    - `name` string — Custom name given to the card, often the card holder name
    - `nature` 'personal' | 'corporate' | 'unknown' — An enumeration.
    - `preferred_network` 'national' | 'visa' | 'mastercard'
    - `network` 'unknown' | 'national' | 'visa' | 'mastercard' — An enumeration.
    - `zip_code` string — Zip code in 2 to 8 digit format
    - `deleted` boolean, required

## Other responses

- `422` — Validation Error

---

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