---
title: "Get cards"
method: GET
path: "/api/v1/cards"
tags: ["Cards"]
---

# Get cards

`GET /api/v1/cards`

Retrieves list of cards that belong to the user

## Query parameters

- `page_number` integer
- `page_size` integer
- `sort` 'name' | 'usage'

## Response `200`

OK

- ResponseCardsResponse
  - `data` ResponseCardResponse[], required — List of cards
    - `allowed_actions` ResponseCardAction[], required — Actions that user can do with the card in the current state
      - `relative_path` string, required — Relative path of the API that executes this action
      - `type` 'Activate' | 'Block' | 'Unblock' | 'Close' | 'SetLimit' | 'GetDetails' | 'GetCvv' | 'GetPin' | 'SetActiveBalance', required
    - `balances` ResponseCardBalance[] — List of balances of the card contract. (<span style="color:red">WOULD</span> be provided for cards which have **generation** set to **Gen1**
      - `balance` number, required — Token balance in the decimal representation
      - `is_active` boolean, required — Indicates whether the token is active for the card
      - `reference_balance` number, required — Reference balance converted to a common currency
      - `reference_currency` string, required — Currency used as the reference for the converted balance (e.g., USD)
      - `token_address` string, required — Address of the token on the blockchain
      - `token_symbol` string, required — Symbol of the token (e.g., USDT)
    - `card_data` ResponseCardData, required
      - `card_name` string, required — Display name of the card
      - `card_number_first_4` string — First 4 digits of the card number. (<span style="color:red">WOULD</span> be present if status **<span style="color:red">IS</span> Requested** or NotActivated**)
      - `card_number_last_4` string — Last 4 digits of the card number. (<span style="color:red">WOULD</span> be present if status **<span style="color:red">IS NOT</span> Requested or NotActivated**)
      - `expiry_date` string — Cards expiry date in MM/YYYY format. (<span style="color:red">WOULD</span> be present if status **<span style="color:red">IS NOT</span> Requested or NotActivated**)
      - `format` 'Plastic' | 'Virtual' | 'Metal', required
      - `name_on_card` string, required — Name printed on the card
      - `payment_system` 'Visa' | 'MasterCard', required
    - `card_wallet_address` string, required — Crypto address of the wallet that is linked to the card
    - `created_at` string, required — Date when the card was created
    - `delivery_address` ResponseDeliveryAddress
      - `city` string, required — City of the address
      - `country` string, required — Country of the address
      - `line1` string, required — Line 1 of unstructured address
      - `line2` string — Line 2 of unstructured address
      - `state` string — State of the address
      - `zip_code` string, required — Postal code of the address
    - `generation` 'Gen1' | 'Gen2', required
    - `id` string, required — Unique identifier of the card
    - `limit` ResponseCardLimit
      - `currency` string, required — ISO 4217 currency code (e.g., USD) in which the limit is set and usage is calculated
      - `daily_limit` number, required — Daily spending limit set for this card
      - `daily_usage` number, required — An amount of money spent today
      - `lifetime_limit` number, required — Lifetime spending limit set for this card
      - `lifetime_usage` number, required — An amount of money spent in total
      - `monthly_limit` number, required — Monthly spending limit set for this card
      - `monthly_usage` number, required — An amount of money spent this month
    - `previous_status` 'Requested' | 'NotActivated' | 'Active' | 'Closed' | 'Blocked'
    - `provider` 'Wirex' | 'Bridge', required
    - `status` 'Requested' | 'NotActivated' | 'Active' | 'Closed' | 'Blocked', required
    - `status_reason` string — Short reason why the card is in the current status
    - `updated_at` string — Date when the card was last updated

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

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