> ## 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.

# Listar Saques

> GET /v2/withdrawals — lista todos os saques com filtros opcionais.

## Parâmetros de query

| Parâmetro               | Tipo    | Descrição                                                  |
| ----------------------- | ------- | ---------------------------------------------------------- |
| `limit`                 | integer | Máximo de resultados por página (padrão: `20`, máx: `100`) |
| `offset`                | integer | Offset de paginação (padrão: `0`)                          |
| `group_id`              | string  | Filtrar por ID do grupo de whitelist                       |
| `address`               | string  | Filtrar por endereço de destino                            |
| `receive_currency_code` | string  | Filtrar por código de moeda (ex: `TRX_USDT_S2UZ`, `BRL`)   |

<Warning>
  Este endpoint **não tem filtro de data**. Diferente de todas as outras rotas de lista, `date_from` / `date_to` não são aceitos aqui — se enviados, são ignorados. Para restringir saques a um período, percorra os resultados e filtre por `created_at` do seu lado.
</Warning>

Um `limit` inválido (valor não numérico) cai para `50`, em vez de devolver erro, e parâmetros de query desconhecidos são ignorados silenciosamente. Os resultados são ordenados do mais recente para o mais antigo.

## Response `200 OK`

Cada item em `results` tem o mesmo formato do response de [Consultar Saque](/pt/api-reference/withdrawals/get). `total` é a contagem de correspondências antes da paginação, então serve para percorrer o conjunto inteiro; `results` é `[]` quando nada corresponde, nunca `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>