> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.usegrade.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transactions

> List and export wallet transactions via /sdk/v1.

All endpoints below require:

* `X-Application-Id`
* `X-Api-Key`

## GET /sdk/v1/transactions

List agency wallet transactions.

### Query parameters

* `page` (default `1`)
* `limit` or `pageSize` (default `50`, max `100`)
* `sortBy` (optional)
* `sortOrder` (`asc|desc`, optional)
* `transactionTypes` or `transactionType` (optional; comma-separated)
* `transactionStatuses` or `transactionStatus` (optional; comma-separated)
* `from` and `to` (optional; ISO timestamps)

If `from`/`to` is provided without a timezone offset, it is treated as UTC.

Supported `transactionTypes` values (invalid values are ignored):

`TOP_UP`, `AGENCY_PAY_OUT`, `CREATOR_PAYMENT`, `TOP_UP_CREDIT`

Supported `transactionStatuses` values (invalid values are ignored):

`SUBMITTED`, `PENDING_VERIFICATION`, `PROCESSING`, `INSTANT_WALLET_TO_WALLET`, `PENDING_WALLET_TO_WALLET`, `DECLINED`, `COMPLETED`

### Response

```json theme={null}
{
  "success": true,
  "data": [
    {
      "transactionId": "txn_...",
      "transactionType": "TOP_UP",
      "transactionStatus": "COMPLETED",
      "transactionTime": "2026-02-19T00:00:00.000Z",
      "displayCurrency": "USD",
      "displayValue": 100,
      "feeDisplayValue": 0
    }
  ],
  "pagination": { "page": 1, "pageSize": 50, "totalItems": 1, "totalPages": 1 }
}
```

## GET /sdk/v1/transactions/export

Export wallet transactions as CSV or PDF.

### Query parameters

* `format` (required): `csv` or `pdf`
* `from` and `to` (required): ISO timestamps
* All filters supported by `GET /sdk/v1/transactions`
* `timeZone` (optional; used for PDF rendering)

### Responses

* `text/csv` with `Content-Disposition: attachment; filename="wallet-transactions-YYYY-MM-DD.csv"`
* `application/pdf` with `Content-Disposition: attachment; filename="wallet-transactions-YYYY-MM-DD.pdf"`

If the export would exceed 10,000 rows: `413` with a JSON error.