Skip to main content
GET
/
cards
/
virtual-cards
/
list
curl -X GET "https://api.cryptomate.me/cards/virtual-cards/list" \
  -H "x-api-key: $CRYPTOMATE_API_KEY"

[
  {
    "id": "card_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23",
    "card_holder_name": "John Doe",
    "type": "VIRTUAL",
    "last4": "4242",
    "status": "ACTIVE",
    "approval_method": "TOP_UP",
    "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"
      }
    }
  }
]
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.
​
id
string
Unique card identifier.
​
card_holder_name
string
Name of the cardholder.
​
type
string
Card type. Possible values: VIRTUAL, PHYSICAL.
​
last4
string
Last 4 digits of the card number.
​
status
string
Card status. Possible values: ACTIVE, DELETED, EXPIRED, FROZEN, INACTIVE, BLOCKED.
​
approval_method
string
Transaction approval method. Possible values: NONE, WEBHOOK, TOP_UP, DEFI.
​
daily_limit
number
Daily spending limit in USD.
​
weekly_limit
number
Weekly spending limit in USD.
​
monthly_limit
number
Monthly spending limit in USD.
​
forwarded_3ds_type
string
3D Secure configuration. Possible values: AUTOMATIC, FORWARDED, DISABLED.
​
meta
object
Additional metadata including email and OTP phone number.
curl -X GET "https://api.cryptomate.me/cards/virtual-cards/list" \
  -H "x-api-key: $CRYPTOMATE_API_KEY"

[
  {
    "id": "card_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23",
    "card_holder_name": "John Doe",
    "type": "VIRTUAL",
    "last4": "4242",
    "status": "ACTIVE",
    "approval_method": "TOP_UP",
    "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"
      }
    }
  }
]