---
title: "List Cards for a User"
method: GET
path: "/v1/cards"
tags: ["Cards"]
---

# List Cards for a User

`GET /v1/cards`

> 📘
>
> You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.

Retrieve all Debit Cards for a user.

> 📘
>
> This resource returns paginated results in descending order.  For more details please see: [Pagination](https://docs.astra.finance/reference/pagination)

## Query parameters

- `include_removed` boolean
- `page_size` integer
- `cursor_id` string

## Response `200`

Successful response

- object
  - `count` integer — The number of cards returned
  - `cards` object[]
    - `id` string — Unique card ID
    - `active` boolean — Whether or not the card is active with the issuing bank
    - `address_verified` boolean — AVS response from debit networks
    - `card_company` string — Name of card company
    - `card_fingerprint` string — A unique identifier derived from the card number
    - `card_type` 'debit' | 'prepaid' | 'credit' | 'unknown' — The type of card
    - `city` string — The city of the card billing address
    - `created` string, date-time — Date and time of card creation
    - `expiration_date` string — Month/Year of card expiration
    - `first_name` string — The first name of card user
    - `first_six_digits` string — The provided Bank Identification Number (BIN)
    - `last_four_digits` string — Last 4 digits of the card number
    - `last_name` string — The last name of card user
    - `name_verification_result` 'Match' | 'No Match' | 'Partial Match' | 'Unknown' — The ANI results from the issuing bank of the card
    - `product_type` 'Consumer' | 'Business' | 'Commercial' | 'Unknown' — The product type of the card
    - `pull_enabled` boolean — Whether or not the card is enabled for pull transactions
    - `push_enabled` boolean — Whether or not the card is enabled for push transactions
    - `aft_enabled` boolean — If true, this card is allowed to be used as a source in routines.
    - `oct_enabled` boolean — If true, this card is allowed to be used as a desetination in routines.
    - `removed` boolean — Whether or not the user has removed the card
    - `review_reasons` object[]
      - `code` string — The review reason code (see [Card Review Reasons](https://docs.astra.finance/reference/card-review-statuses#review-reasons))
      - `description` string — The review reason description (see [Card Review Reasons](https://docs.astra.finance/reference/card-review-statuses#review-reasons))
    - `reviewed_at` string, date-time — The date and time the Card was reviewed
    - `review_status` 'approved' | 'flagged' | 'rejected' — (Deprecated) Review status of the card
    - `state` string — Card address state
    - `status` 'approved' | 'flagged' | 'rejected' | 'removed' — The status of the card ([Card Statuses](https://docs.astra.finance/reference/card-review-statuses#card-statuses))
    - `street_line_1` string — The street line 1 of the card billing address
    - `street_line_2` string — The street line 2 of the card billing address
    - `zip_code` string — The zip code of the card billing address
  - `next_cursor_id` string — The next cursor ID, for resuming a paginated query
  - `has_next_page` boolean — Whether the paginated query has additional pages (value may be null if no there are no additional pages)

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/astra/apis/astra-developer-api.md) · [All operations](https://skmtc.net/astra/apis/astra-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astra/astra-developer-api/revisions/09f0430e5d33/schema)