Card Transactions

Returns a card’s transaction history (settlements, refunds, cross-border, declines…). This is the per-card statement; your USD card-wallet transactions (funding, top-ups, fees) are separate. Each row includes the transaction reference, type, status, amount, currency, time, description and available merchant/network/country information. Use these fields for a transaction-detail view; a card-activity reference is not a bank-transfer reference. authAmount is the recorded authorized amount, settledAmount is the recorded settled amount, and balanceAfter is the historical card balance immediately after the event. These fields are nullable: unavailable is not zero. For Decline, amount is the attempted amount and both authAmount and settledAmount are null; do not present it as a completed debit.

Card endpoints use the same base URL and API key as the rest of the API, and are signature-gated: send X-Numero-Signature and X-Numero-Signature-Version: v2 as well. See Request signing.

Endpoint

GET /api/v1/business/card/{reference}/transactions

Signature required: Yes

Headers

Header	Required	Description
`X-Numero-Api-Key`	Yes	Your API key
`X-Numero-Signature`	Yes	Base64 HMAC-SHA256 over the exact raw request body (POST) or the canonicalised query string (GET), keyed with your Public Key. See Request signing.
`X-Numero-Signature-Version`	Yes	Always `v2`.

Path parameters

Parameter	Type	Required	Description
`reference`	string	Yes	The card reference

Query parameters

Parameter	Type	Required	Description
`pageNumber`	integer	No	Page number (default 1)
`pageSize`	integer	No	Page size (default 50)

Request example

curl -X GET "https://api.usenumero.com/numeroaccount/api/v1/business/card/NCRD24AD18BEBD474A/transactions" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2"

Response

{
  "data": {
    "cardReference": "NCRD24AD18BEBD474A",
    "transactions": [
      {
        "reference": "CTXN-0001",
        "type": "Settlement",
        "amount": 9.99,
        "authAmount": 9.99,
        "settledAmount": 9.99,
        "balanceAfter": 15.01,
        "currency": "USD",
        "status": "Successful",
        "description": "ACME SaaS",
        "merchantName": "ACME",
        "merchantId": "MID123",
        "network": "Visa",
        "country": "US",
        "occurredAt": "2026-06-16T12:00:00Z"
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}

Getting Started

Transfers & Payouts

Collections (Virtual Accounts)

Wallet-as-a-Service

Customers

Invoices

Cards

Cardholders

Balance & Transactions

Value Added Services

Credit

Verification / KYC

Webhooks

Card Transactions

Endpoint

Headers

Path parameters

Query parameters

Request example

Response

​Endpoint

​Headers

​Path parameters

​Query parameters

​Request example

​Response

Endpoint

Headers

Path parameters

Query parameters

Request example

Response