# List wallet transactions (/docs/api-reference/wallets/get-transactions)

`GET /v1/wallets/{walletId}/transactions`

Lists a wallet's transactions, newest first, with optional filters.

Returns `{ transactions, pagination }`. In a transaction, `type` `debit` takes funds from the
wallet and `credit` adds funds to it; `source` says why (`topUp`, `payOut`,
`order`, `exchange` or `reversal`), and `orderId` names the order a payment or refund
belongs to. Filters combine with AND and apply before counting and paging.
            
Use flat `page` (default 1) and `limit` (default 10, 1 to 100) query parameters.
`cursor`, `skip`, `offset`, nested paging keys and repeated paging parameters return
`400` with code `10001` (`INVALID_REQUEST`). An unknown wallet returns `404` with code
`10004`.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `walletId` | path | yes | `string` | Wallet id. |
| `page` | query | no | `integer` | One-based page number. Default 1. |
| `limit` | query | no | `integer` | Page size, 1 to 100. Default 10. |
| `startDate` | query | no | `string` | Only transactions made at or after this time (UTC). ISO 8601 date-time. A value with Z or an offset is converted to UTC; a value without a zone is read as UTC, and a date alone means 00:00 UTC on that day. |
| `endDate` | query | no | `string` | Only transactions made at or before this time (UTC). ISO 8601 date-time. A value with Z or an offset is converted to UTC; a value without a zone is read as UTC, and a date alone means 00:00 UTC on that day. |
| `type` | query | no | `string` | Only this direction: `debit` takes funds from the wallet, `credit` adds funds to it. |
| `source` | query | no | `string` | Only transactions with this cause, such as `order` or `exchange`. |

## Responses

### 200

OK

- `text/plain`: `WalletTransactionList`
- `application/json`: `WalletTransactionList`
- `text/json`: `WalletTransactionList`

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 401

Unauthorized

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 404

Not Found

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.