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

# Get cards

`GET /api/v1/cards`

## Request

- Base URL: `https://api-business.wirexapp.com`
- URL: `https://api-business.wirexapp.com/api/v1/cards`
- Auth: API key in header `Authorization`

Retrieves list of cards that current user has access to

## Query parameters

- `employee_id` string
- `page_number` integer
- `page_size` integer

## 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', required
    - `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 this card wallet
    - `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
    - `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
      - `monthly_limit` number, required: Monthly spending limit set for this card
      - `monthly_usage` number, required: Monthly amount of money spent in the current month
      - `transaction_limit` number, required: Transaction limit set for this card
    - `previous_status` 'Requested' | 'NotActivated' | 'Active' | 'Closed' | 'Blocked'
    - `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-corporate-baas-api.md) - [All operations](https://skmtc.dev/wirexapp/apis/wirex-corporate-baas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wirexapp/apis/wirex-corporate-baas-api/revisions/6525bfbc8f99?raw)