> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cryptomate.me/llms.txt
> Use this file to discover all available pages before exploring further.

# List virtual cards

> Retrieve all virtual cards for the authenticated company.

Retrieves a list of all virtual cards for the authenticated company. Requires an API key with access level 1 or higher.

## Response

Returns an array of virtual card objects.

<ResponseField name="id" type="string">
  Unique card identifier.
</ResponseField>

<ResponseField name="card_holder_name" type="string">
  Name of the cardholder.
</ResponseField>

<ResponseField name="type" type="string">
  Card type. Possible values: `VIRTUAL`, `PHYSICAL`.
</ResponseField>

<ResponseField name="last4" type="string">
  Last 4 digits of the card number.
</ResponseField>

<ResponseField name="status" type="string">
  Card status. Possible values: `ACTIVE`, `DELETED`, `EXPIRED`, `FROZEN`, `INACTIVE`, `BLOCKED`.
</ResponseField>

<ResponseField name="approval_method" type="string">
  Transaction approval method. Possible values: `NONE`, `WEBHOOK`, `TOPUP`, `DEFI`.
</ResponseField>

<ResponseField name="daily_limit" type="number">
  Daily spending limit in USD.
</ResponseField>

<ResponseField name="weekly_limit" type="number">
  Weekly spending limit in USD.
</ResponseField>

<ResponseField name="monthly_limit" type="number">
  Monthly spending limit in USD.
</ResponseField>

<ResponseField name="forwarded_3ds_type" type="string">
  3D Secure configuration. Possible values: `AUTOMATIC`, `FORWARDED`, `DISABLED`.
</ResponseField>

<ResponseField name="meta" type="object">
  Additional metadata including email and OTP phone number.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.cryptomate.me/cards/virtual-cards/list" \
    -H "x-api-key: $CRYPTOMATE_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  [
    {
      "id": "card_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23",
      "card_holder_name": "John Doe",
      "type": "VIRTUAL",
      "last4": "4242",
      "status": "ACTIVE",
      "approval_method": "TOPUP",
      "daily_limit": 1000.00,
      "weekly_limit": 5000.00,
      "monthly_limit": 20000.00,
      "forwarded_3ds_type": "AUTOMATIC",
      "meta": {
        "email": "cardholder@example.com",
        "otp_phone_number": {
          "dial_code": 1,
          "phone_number": "5551234567"
        }
      }
    }
  ]
  ```
</ResponseExample>