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

# List Cards

`GET /cards`

## Query parameters

- `cursor` string — Return the page of entries after this one.
- `limit` integer — Limit the size of the list that is returned. The default (and maximum) is 100 objects.
- `account_id` string — Filter Cards to ones belonging to the specified Account.
- `created_at.after` string, date-time — Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.before` string, date-time — Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_after` string, date-time — Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_before` string, date-time — Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `status.in` string[] — Filter Cards by status. For GET requests, this should be encoded as a comma-delimited string, such as `?in=one,two,three`.
- `idempotency_key` string — Filter records to the one with the specified `idempotency_key` you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).

## Response `200`

Card List

- CardList — A list of Card objects.
  - `data` Card[], required — The contents of the list.
    - `account_id` string, required — The identifier for the account this card belongs to.
    - `billing_address` object, required — The Card's billing address.
      - `city` string, nullable, required — The city of the billing address.
      - `line1` string, nullable, required — The first line of the billing address.
      - `line2` string, nullable, required — The second line of the billing address.
      - `postal_code` string, nullable, required — The postal code of the billing address.
      - `state` string, nullable, required — The US state of the billing address.
    - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card was created.
    - `description` string, nullable, required — The card's description for display purposes.
    - `digital_wallet` object, nullable, required — The contact information used in the two-factor steps for digital wallet card creation. At least one field must be present to complete the digital wallet steps.
      - `digital_card_profile_id` string, nullable, required — The digital card profile assigned to this digital card. Card profiles may also be assigned at the program level.
      - `email` string, nullable, required — An email address that can be used to verify the cardholder via one-time passcode over email.
      - `phone` string, nullable, required — A phone number that can be used to verify the cardholder via one-time passcode over SMS.
    - `entity_id` string, nullable, required — The identifier for the entity associated with this card.
    - `expiration_month` integer, required — The month the card expires in M format (e.g., August is 8).
    - `expiration_year` integer, required — The year the card expires in YYYY format (e.g., 2025).
    - `id` string, required — The card identifier.
    - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
    - `last4` string, required — The last 4 digits of the Card's Primary Account Number.
    - `status` 'active' | 'disabled' | 'canceled', required — This indicates if payments can be made with the card.
    - `type` 'card', required — A constant representing the object's type. For this resource it will always be `card`.
  - `next_cursor` string, nullable, required — A pointer to a place in the list.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

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