> ## Documentation Index
> Fetch the complete documentation index at: https://guides.saber.money/llms.txt
> Use this file to discover all available pages before exploring further.

# List Transactions

> Lists the caller's unified transactions, newest first, with optional filters and pagination.

Lists the caller's transactions, newest first (`created_at` descending, then `id` descending).

Authenticate with the HMAC headers described in [Conventions and Authentication](https://guides.saber.money/api-reference/unified-transaction/conventions.md). Body: none.

**X-Api-Key** `string` *required*

API key. Alias: `X-Client-Id`.

**X-Timestamp** `string` *required*

Unix time in seconds. Must be within 600 s of server time.

**X-Signature** `string` *required*

Hex HMAC-SHA256 of `X-Api-Key` + `X-Timestamp`, keyed with the API secret. Upper or lower case hex. Alias: `X-Secret-Key`.

**X-Request-Id** `string` *required*

Unique id per request, e.g. a UUID.

> [!WARNING]
>
> Do not send `X-User-Id` or `X-Source` on this endpoint.

**transaction\_type** `string`

`POOL_SELL`. Case-insensitive.

**status** `string`

A client status, see [Transaction Object and Statuses](https://guides.saber.money/api-reference/unified-transaction/transaction-object.md#statuses). Repeat the parameter for several: `status=CREATED&status=FAILED`. Comma-separated values are rejected.

**client\_reference\_id** `string`

Exact match.

**created\_after** `integer`

Epoch ms, inclusive.

**created\_before** `integer`

Epoch ms, exclusive. Must be greater than `created_after`.

**limit** `integer` (default: 20)

1 to 100.

**offset** `integer` (default: 0)

0 to 2147483647.

## Response

`200 OK`.

**transactions** `array`

Transaction objects ([see Transaction Object](https://guides.saber.money/api-reference/unified-transaction/transaction-object.md)) for the requested page.

**total** `integer`

Count of all transactions matching the filters, ignoring `limit` and `offset`.

## Status and error codes

| HTTP | Codes |
| - | - |
| 200 | OK |
| 400 | `400001` (invalid query parameter) |
| 401, 403, 404, 500 | Gateway and authentication codes, `499999` |

Full list in the [Error List](https://guides.saber.money/api-reference/unified-transaction/errors.md).

```bash cURL theme={null}
curl "https://<sandbox-host>/api/v2/wallet/transaction/unified?created_before=1793024950702&offset=0&limit=5" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Signature: $SIGNATURE" \
  -H "X-Request-Id: $(uuidgen)"
```

```json 200 OK (sandbox, captured, transactions shortened to the first of 5 elements) theme={null}
{
  "success": true,
  "data": {
    "transactions": [
      {
        "id": "00000000-0000-4000-8000-000000000001",
        "client_reference_id": "order-12345",
        "transaction_type": "POOL_SELL",
        "status": "SENDER_KYC_VERIFIED",
        "reason_code": null,
        "reason_desc": null,
        "from_currency": "USDT",
        "to_currency": "INR",
        "from_amount": "1",
        "to_amount": null,
        "exchange_rate": null,
        "payment_method": "bank_transfer",
        "purpose_code": "P1301",
        "quote_id": null,
        "bank_transaction_id": null,
        "sender_id": "00000000-0000-4000-8000-000000000003",
        "beneficiary_id": "00000000-0000-4000-8000-000000000004",
        "beneficiary_instrument_id": null,
        "beneficiary_instrument_type": "BANK_ACCOUNT",
        "beneficiary_relationship": "FAMILY",
        "created_at": 1793024948000,
        "updated_at": 1793024950000
      }
    ],
    "total": 1328
  }
}
```

```json 400 status=CREATED%2CFAILED (sandbox, captured) theme={null}
{"success":false,"errors":[{"code":400001,"text":"missing or invalid parameters"}]}
```


## Related topics

- [Error List](https://guides.saber.money/api-reference/unified-transaction/errors.md)
- [Get List of Buy Transactions](https://guides.saber.money/api-reference/onramp/to-external-wallet/get-list-of-buy-transactions.md)
- [Get List of Sell Transactions](https://guides.saber.money/api-reference/offramp/from-user-wallet/get-list-of-sell-transactions.md)
- [Get List of Crypto Deposit Transactions](https://guides.saber.money/api-reference/wallet-operations/crypto-deposit/get-list-of-crypto-deposit-transactions.md)
- [Get List of Pool Buy Transactions](https://guides.saber.money/api-reference/onramp/to-pool-wallet/get-list-of-pool-buy-transactions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.