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

Last updated