---
title: "Retrieve all cards"
method: GET
path: "/cards"
tags: ["Card", "Swipe"]
---

# Retrieve all cards

`GET /cards`

## Query parameters

- `page` number, float
- `limit` number, float
- `status` string — Comma-separated list of card statuses [ex: ACTIVE,FROZEN,DELETED,EXPIRED,BLOCKED,INACTIVE,INTERNAL_REVIEW_FAILED]
- `metadataId` string — Comma-separated list of card metadata IDs

## Headers

- `Accept-Version` string, required — Specifies the API version to use for this request.

## Response `200`

Return cards list for the user

- object
  - `items` object[]
    - `id` string, required
    - `cardName` string, required
    - `secondaryCardName` string
    - `cardType` string, required
    - `last4` string, required
    - `availableCredit` string, required
    - `status` 'ACTIVE' | 'DELETED' | 'EXPIRED' | 'FROZEN' | 'INACTIVE' | 'BLOCKED' | 'INTERNAL_REVIEW_FAILED', required
    - `freezeReason` string
    - `statusReason` string
    - `physicalCardStatus` 'NOT_PHYSICAL_CARD' | 'CARD_NOT_ORDERED' | 'CARD_PRODUCTION_REQUESTED' | 'CARD_IN_PRODUCTION' | 'CARD_PRODUCTION_COMPLETED' | 'CARD_ACTIVATED' | 'CARD_PRODUCTION_CANCELED' | 'CARD_PRODUCTION_ONHOLD', required
    - `shippingAddress` object, required — A delivery address.
      - `line1` string, required — Address line 1 (e.g. flat, floor, building name).
      - `line2` string, nullable — Address line 2 (e.g. street, district).
      - `zone` string, nullable — State, county, province, or region.
      - `city` string, required — City, district, or town of the delivery address.
      - `postalCode` string, required — Postal code of the address. Only Arabic numerals **0-9**, Latin letters (A-Z, a-z), spaces, and hyphens (**-**) are allowed.
      - `country` string, required — Two-letter country code ([ISO 3166-1 Alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
    - `spendControl` object
      - `spendControlCap` object
        - `transactionLimit` string — The updated maximum amount allowed per transaction.
        - `dailyLimit` string — The updated total spend limit allowed per day.
        - `weeklyLimit` string — The updated total spend limit allowed per week.
        - `monthlyLimit` string — The updated total spend limit allowed per month.
        - `yearlyLimit` string — The updated total spend limit allowed per year.
        - `allTimeLimit` string — The updated total spend limit allowed over the card’s lifetime.
      - `spendControlAmount` object
        - `dailySpent` string
        - `weeklySpent` string
        - `monthlySpent` string
        - `yearlySpent` string
        - `allTimeSpent` string
      - `atmControl` object
        - `dailyFrequency` string
        - `dailyWithdrawal` string
        - `monthlyFrequency` string
        - `monthlyWithdrawal` string
        - `yearlyFrequency` string
        - `yearlyWithdrawal` string
    - `threeDSForwarding` boolean
    - `cardDesign` string, uuid
    - `bulkShippingId` string
    - `meta` object — Any supplementary data about the cardholder, used to identify the user in Reap’s system. Examples include the cardholder’s type or preferences. A phone number and a client ID are required in this field.
      - `id` string, required — A unique identifier for the cardholder in your system.
      - `email` string, email, nullable — The cardholder’s email, used as a communication channel for authentication during various occasions (e.g., 3DS checkout, mobile wallet verification). It is highly recommended to provide this field to ensure a seamless authentication experience.
      - `otpPhoneNumber` object, required — The cardholder’s phone number, used for receiving SMS notifications related to authentication (e.g., 3DS checkout, mobile wallet verification).
        - `dialCode` number, float, required — The [country dial-in code](https://en.wikipedia.org/wiki/List_of_country_calling_codes#Alphabetical_order). for the cardholder’s phone number. The ‘+’ sign is not needed.
        - `phoneNumber` string, required — The cardholder’s phone number, including the area code.
  - `meta` object — Pagination metadata for the response.
    - `itemCount` number, float, required — The number of items returned on the current page.
    - `totalItems` number, float, required — The total number of items across all pages.
    - `itemsPerPage` number, float, required — The maximum number of items that can be returned per page.
    - `totalPages` number, float, required — The total number of pages available based on the **itemsPerPage** and **totalItems**.
    - `currentPage` number, float, required — The current page number in the paginated response.

## Other responses

- `404` — Account not found

---

[API](https://skmtc.net/reap-global/apis/reap-api.md) · [All operations](https://skmtc.net/reap-global/apis/reap-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reap-global/reap-api/revisions/525072733e02/schema)