> For the complete documentation index, see [llms.txt](https://docs.cardspro.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cardspro.com/api/cards/card-transactions.md).

# 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:**

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

**Request Parameters:**

<table><thead><tr><th width="108.22216796875">Field</th><th width="112.3333740234375">Type</th><th width="105.111083984375">Required</th><th width="197.4444580078125">Constraints</th><th>Description</th></tr></thead><tbody><tr><td><code>page</code></td><td>Number</td><td>Yes</td><td>>= 0</td><td>Page number (0-based)</td></tr><tr><td><code>size</code></td><td>Number</td><td>Yes</td><td>1-100</td><td>Number of transactions per page</td></tr><tr><td><code>from</code></td><td>String</td><td>No</td><td>ISO-8601 format(UTC)</td><td>Start date for filtering</td></tr><tr><td><code>to</code></td><td>String</td><td>No</td><td>ISO-8601 format(UTC)</td><td>End date for filtering</td></tr></tbody></table>

**Response:**

```json
{
  "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:**

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

**Transaction Status Values:**

<table><thead><tr><th width="314.4444580078125">Status</th><th>Description</th></tr></thead><tbody><tr><td><code>authorization</code></td><td>Transaction authorization pending</td></tr><tr><td><code>authorization_decline</code></td><td>Transaction declined or cancelled</td></tr><tr><td><code>expense</code></td><td>Completed expense/purchase transaction</td></tr><tr><td><code>refund</code></td><td>Refund transaction completed</td></tr><tr><td><code>reversal</code></td><td>Transaction reversed</td></tr><tr><td><code>maintenance_fee</code></td><td>Card maintenance or service fee</td></tr></tbody></table>