Card Transactions

Retrieves paginated transaction history for a card.

Endpoint: POST /{san}/transactions

Path Parameters:

• san - Secure Account Number (card identifier)

Content-Type: application/json

Request Body:

{
  "page": 0,
  "size": 20,
  "from": "2026-01-01T00:00:00.000Z",
  "to": "2026-02-04T23:59:59.999Z"
}

Request Parameters:

Field	Type	Required	Constraints	Description
page	Number	Yes	>= 0	Page number (0-based)
size	Number	Yes	1-100	Number of transactions per page
from	String	No	ISO-8601 format(UTC)	Start date for filtering
to	String	No	ISO-8601 format(UTC)	End date for filtering

Response:

{
  "total": 6,
  "list": [
    {
      "id": "948b42f1-7dcf-43c0-a503-4e0287b9d9c1",
      "date": "2026-01-10T18:34:03.71Z",
      "authorizationCode": "744126",
      "transactionId": "A2024190693782999041",
      "isForcePost": false,
      "transactionSum": 5,
      "transactionCommission": 0,
      "cardCurrency": "USD",
      "originTxId": "A2024190524630913026",
      "txAmount": 5,
      "txCurrency": "USD",
      "transactionRecipient": "GGG.COM SURREY GBR",
      "merchantCategory": "5734 COMPUTER SOFTWARE STORES",
      "transactionValue": 5,
      "declineReason": null,
      "status": "expense"
    }
  ]
}

Response Parameters:

Field	Type	Description
total	Number	Total number of transactions matching the query
list	Array	Array of transaction objects
list[].date	String (ISO 8601)	Transaction date and time in UTC
list[].authorizationCode	String or null	Authorization code for the transaction (if available)
list[].transactionId	String	Unique transaction identifier
list[].isForcePost	Boolean	Indicates if the transaction was force-posted
list[].transactionSum	Decimal	Total transaction amount including commission
list[].transactionCommission	Decimal	Commission fee charged for the transaction
list[].cardCurrency	String	Currency code of the card (USD, EUR)
list[].originTxId	String or null	Original transaction identifier
list[].txAmount	Decimal	Transaction amount in the original transaction currency
list[].txCurrency	String	Currency code of the original transaction (USD, EUR, etc.)
list[].transactionRecipient	String	Merchant name and location information
list[].merchantCategory	String or null	Merchant category code (MCC) if available
list[].id	String (UUID)	Internal transaction record identifier
list[].transactionValue	Decimal	Transaction amount before commission
list[].declineReason	String or null	Reason for decline if transaction was declined
list[].status	String	Transaction status (expense, income, declined, etc.)

Transaction Status Values:

Status	Description
authorization	Transaction authorization pending
authorization_decline	Transaction declined or cancelled
expense	Completed expense/purchase transaction
refund	Refund transaction completed
reversal	Transaction reversed
maintenance_fee	Card maintenance or service fee