List virtual cards

GET

/virtual-cards

Returns a paginated list of virtual cards belonging to the authenticated entity, ordered newest first. A virtual card is a card-issuing instrument funded from one of your accounts, which can be created directly or gated behind a maker-checker approval workflow. Use the optional query parameters to filter by status, funding account, currency, or your own client reference. Pagination is cursor-based: pass the cursor value from the previous response's meta.pagination.cursor field to fetch the next page. When has_more is false, you have reached the end of the list.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Virtual cards retrieved successfully. Returns a page of virtual cards and pagination metadata.

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location '/virtual-cards?status=active&statuses=active%2Cpending-approval&search=ada%40example.com&account_id=01HQZR2BKPFQ8MXJVT3G7LWNC&currency=USD&client_reference=card-ref-20260806-001&created_from=1754438400000&created_to=1754524800000&include_total=true&cursor=01HQZR2BKPFQ8MXJVT3G7LWNA&limit=20' \
--header 'Authorization: Bearer <token>'

Response Example

200 - First page — more results available

{
    "message": "Virtual cards retrieved successfully",
    "status": "success",
    "data": [
        {
            "id": "01HQZR2BKPFQ8MXJVT3G7LWNE",
            "entity_id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
            "account_id": "01HQZR2BKPFQ8MXJVT3G7LWNC",
            "cardholder": {
                "name": "Ada Lovelace",
                "email": "ada@example.com"
            },
            "billing_address": {
                "line_one": "221B Baker Street",
                "country": "GB",
                "code": "NW16XE",
                "code_type": "postal",
                "city": "London",
                "state": "London"
            },
            "masked_pan": "411111****1111",
            "expiry": {
                "month": "09",
                "year": "30"
            },
            "currency": "USD",
            "status": "active",
            "description": "Marketing team subscriptions card",
            "cached_balance": 500000,
            "creation_fee": 250,
            "type": "self-contained",
            "card_brand": "visa",
            "client_reference": "card-ref-20260806-001",
            "client_meta": {
                "department": "marketing"
            },
            "maker_checker_approver_group_id": null,
            "payment_intent_id": "01HQZR2BKPFQ8MXJVT3G7LWNH",
            "payout_intent_id": "01HQZR2BKPFQ8MXJVT3G7LWNJ",
            "limits": {
                "per_transaction": 100000,
                "daily": 300000,
                "monthly": 2000000
            },
            "created": 1754524800000,
            "updated": 1754524800000
        }
    ],
    "meta": {
        "pagination": {
            "cursor": "01HQZR2BKPFQ8MXJVT3G7LWNE",
            "has_more": true,
            "total": null
        }
    }
}

Modified at 2026-09-30 00:29:30

Create a virtual card

Update a virtual card