List virtual cards

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": "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"
      }
    }
  }
]

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": "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"
      }
    }
  }
]

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.

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, TOPUP, 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": "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"
      }
    }
  }
]

Overview Get virtual card

Virtual Cards

Transactions

Holding

Account

Webhooks

Response

​Response

Response