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

# Retrieve Card

`GET /cards/{cardId}`

## Path parameters

- `cardId` string, uuid, required

## Headers

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

## Response `200`

Return card summary for the user

- object
  - `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
  - `shippingInformation` object
    - `bulkShippingID` string
    - `sku` 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.

## Other responses

- `404` — Card 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/versions/525072733e02/schema)