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

# List Withdrawals

> GET /v2/withdrawals — list all withdrawals with optional filters.

## Query parameters

| Parameter               | Type    | Description                                           |
| ----------------------- | ------- | ----------------------------------------------------- |
| `limit`                 | integer | Max results per page (default: `20`, max: `100`)      |
| `offset`                | integer | Pagination offset (default: `0`)                      |
| `group_id`              | string  | Filter by whitelist group ID                          |
| `address`               | string  | Filter by destination address                         |
| `receive_currency_code` | string  | Filter by currency code (e.g. `TRX_USDT_S2UZ`, `BRL`) |

<Warning>
  This endpoint has **no date filter**. Unlike every other list route, `date_from` / `date_to` are not accepted here — send them and they are ignored. To restrict withdrawals to a period, page through the results and filter on `created_at` on your side.
</Warning>

An invalid `limit` (a non-numeric value) falls back to `50` rather than returning an error, and unknown query parameters are ignored silently. Results are ordered newest first.

## Response `200 OK`

Each item in `results` has the same shape as the [Get Withdrawal](/api-reference/withdrawals/get) response. `total` is the match count before pagination; `results` is `[]` when nothing matches, never `null`.

<RequestExample>
  ```bash cURL theme={null}
  curl "https://checkout.noxpay.io/v2/withdrawals?limit=20&offset=0" \
    -H "api-key: <key>"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://checkout.noxpay.io/v2/withdrawals",
      headers={"api-key": "<key>"},
      params={"limit": 20, "offset": 0},
  )
  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const params = new URLSearchParams({ limit: 20, offset: 0 });
  const response = await fetch(
    `https://checkout.noxpay.io/v2/withdrawals?${params}`,
    { headers: { "api-key": "<key>" } }
  );
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "version": "v2",
    "total": 3,
    "limit": 20,
    "offset": 0,
    "results": []
  }
  ```
</ResponseExample>