v1

latestOpenAPI 3.0.02026-07-267331140.7 KB

Transactions

List Card Transactions

Retrieves paginated transactions for all activated cards of the authenticated user.

Returns three types of transaction events:

Payment: Regular card transactions (purchases, ATM withdrawals). Can appear immediately after authorization with isPending: true, then update when cleared.
Refund: Money returned to your account (product returns, cancellations). Only appears after both authorization and clearing are processed.
Reversal: Cancellation of previous transactions due to technical issues or merchant corrections. Can appear immediately after authorization-level reversals.

The final number might differ slightly, as one thread might contain multiple transactions.

get/api/v1/cards/transactions

cardTokensstring

Comma-separated list of card tokens

limitinteger

Maximum number of transactions to return

offsetinteger

Number of transactions to skip

beforestring date-time

Filter transactions before this date (ISO 8601 format, e.g., "2023-04-01T00:00:00Z")

afterstring date-time

Filter transactions after this date (ISO 8601 format, e.g., "2023-03-01T00:00:00Z")

billingCurrencystring

Filter by billing currency code

transactionCurrencystring

Filter by transaction currency code

mccstring

Filter by Merchant Category Code (MCC)

transactionTypestring

Filter by transaction type code (e.g., "00" for Purchase, "01" for Withdrawal)

Successful response with paginated transaction events

countinteger

Total number of transactions available

nextstring nullable

URL for the next page of results, null if no more pages

previousstring nullable

URL for the previous page of results, null if on first page

{
  "count": 25,
  "next": "/api/v1/cards/transactions?limit=100&offset=100",
  "results": [
    {
      "threadId": "1234567890"
    }
  ]
}