List a virtual card's activity

GET

/virtual-card-activity

Returns a combined, paginated feed of activity for a single virtual card: successful transactions made on the card (funding, spend, refunds) interleaved with declined authorization attempts, ordered newest first by id. Use this to build a single activity/timeline view for a card instead of querying transactions and declines separately. Each entry carries an entry_type field ('transaction' or 'decline') that tells you which shape to expect. Pagination is cursor-based: pass the meta.pagination.cursor value from a response as the cursor query parameter to fetch the next page; meta.pagination.has_more is false once you've reached the end.

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 card activity retrieved successfully. Returns a page of combined transaction and decline entries and pagination metadata.

Bodyapplication/json

🟠400

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/virtual-card-activity?virtual_card_id=01HQZR2BKPFQ8MXJVT3G7LWNV&cursor=01HQZR2BKPFQ8MXJVT3G7LWNE&limit=20' \
--header 'Authorization: Bearer <token>'

Response Example

200 - First page — mixed transaction and decline entries, more results available

{
    "message": "Virtual card activity retrieved successfully",
    "status": "success",
    "data": [
        {
            "entry_type": "transaction",
            "id": "01HQZR2BKPFQ8MXJVT3G7LWNZ",
            "entity_id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
            "account_id": "01HQZR2BKPFQ8MXJVT3G7LWNB",
            "direction": "outflow",
            "type": "payout",
            "amount": 5000,
            "currency": "USD",
            "applicable_fee": 50,
            "balance_after": 44950,
            "status": "successful",
            "status_reason": null,
            "narration": "Card spend at MERCHANT-INC",
            "counterparty_id": "01HQZR2BKPFQ8MXJVT3G7LWNC",
            "initiating_counterparty": {
                "entity_name": "Acme Inc",
                "account_name": "Acme Operating"
            },
            "receiving_counterparty": {
                "entity_name": "MERCHANT-INC",
                "account_name": "Merchant Settlement"
            },
            "source": {
                "type": "payout_intent_action",
                "id": "01HQZR2BKPFQ8MXJVT3G7LWND"
            },
            "created": 1754524900000,
            "updated": 1754524900000
        },
        {
            "entry_type": "decline",
            "id": "01HQZR2BKPFQ8MXJVT3G7LWNF",
            "entity_id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
            "account_id": "01HQZR2BKPFQ8MXJVT3G7LWNB",
            "amount": 12000,
            "currency": "USD",
            "status": "failed",
            "status_reason": "Insufficient card balance",
            "narration": "Attempted spend at MERCHANT-INC",
            "created": 1754524800000,
            "updated": 1754524800000
        }
    ],
    "meta": {
        "pagination": {
            "cursor": "01HQZR2BKPFQ8MXJVT3G7LWNF",
            "has_more": true
        }
    }
}

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

List transactions

Create a virtual card viewing session