---
title: "List Cards"
method: GET
path: "/card"
tags: ["Card"]
---

# List Cards

`GET /card`

## Query parameters

- `account_id` string
- `card_product_id` string
- `last4` string
- `person_id` string
- `show_cvv` 'true' | 'false'
- `show_pan` 'true' | 'false'
- `status` string
- `page_cursor` string
- `page_size` integer
- `from_date` string
- `to_date` string

## Response `200`

A dictionary with a `data` property that contains a list of up to `page_size` card elements, starting after the card described by `page_cursor`. If no more cards are available, the resulting list will be empty.

- object
  - `data` object[]
    - `account_id` string — The ID of the account that the card should be issued against. Filterable.
    - `card_controls` object — An object that defines rules for how this card can be used
      - `controls` object[]
        - `amount` number, float
        - `interval` string
        - `mccs` string[]
        - `mids` string[]
        - `restriction` string
        - `rollover_time` string
        - `timezone` string
        - `type` string
        - `version` integer
        - `window` integer
      - `name` string
    - `card_product_id` string — The ID of the card product that this card should be issued from. Filterable.
    - `creation_options` object — An object that defines additional fields for card customization on creation
      - `name_line_one` string — Specifies the first line of personalized text that appears on the card. (max 21 characters)
      - `name_line_two` string — Specifies the second line of personalized text that appears on the card. (max 21 characters)
    - `cvv` string — The 3-digit card verification code. Note this field will return null unless the `show_cvv` query parameter is set
    - `expiration` string — The card expiration year and month, in MMYY format
    - `fulfillment` object — Information about the card's fulfillment process
      - `shipping_method` string — The shipping service used
      - `status` string — One of: `issued`, `ordered`, `reordered`, `rejected`, `shipped`, `digitally_presented`
      - `tracking_number` string — A tracking number for eligible card manufacturers and shipping methods
    - `id` string — Unique identifier for object
    - `last4` string — Last 4 digits of the card number. Filterable.
    - `new_pan_from_card_id` string — The ID of a card to reissue. If this field is entered a new card will be created without pin, a new PAN, CVV and expiration
    - `pan` string — The primary 16-digit card number. Note this field will return null unless the `show_pan` parameter is set
    - `person_id` string — The ID of the person representing the cardholder that this card will be issued to. Filterable.
    - `pin_is_set` boolean — Reflects whether the user has set a PIN on the card; initially false
    - `reissue_pan_from_card_id` string — The ID of a card to reissue. If this field is entered a new card will be created with the same PAN and pin, but new CVV and expiration.
    - `show_cvv` 'true' | 'false' — When true, the `cvv` field will be returned with non-null data. False by default. Requires PCI compliance.
    - `show_pan` 'true' | 'false' — When true, the `pan` field will be returned with non-null data. False by default. Requires PCI compliance.
    - `status` string — One of: `unactivated`, `active`, `suspended`, `terminated`. Filterable.
    - `userdata` object — Optional arbitrary user data

---

[API](https://skmtc.net/treasuryprime/apis/account.md) · [All operations](https://skmtc.net/treasuryprime/apis/account/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasuryprime/account/revisions/95a3c69c14e8/schema)