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

> GET /v2/offramps — lista todas as transações de offramp 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`)                          |
| `pix_e2e`       | string  | Filtrar pelo ID end-to-end do PIX                          |
| `client_tax_id` | string  | Filtrar por CPF ou CNPJ do beneficiário                    |
| `wallet`        | string  | Filtrar por endereço de carteira de origem                 |
| `date_from`     | string  | Filtro de data de início — RFC 3339 ou `YYYY-MM-DD`        |
| `date_to`       | string  | Filtro de data de fim — RFC 3339 ou `YYYY-MM-DD`           |

Os dois limites de data são inclusivos e aceitam RFC 3339 (`2026-08-20T14:22:00Z`) além de `YYYY-MM-DD`.

<Warning>
  Um `YYYY-MM-DD` puro em `date_to` resolve para **meia-noite** do início daquele dia, então `date_to=2026-08-20` exclui tudo que aconteceu durante o dia 20 de agosto. Para cobrir o dia inteiro, passe o dia seguinte, ou use um timestamp RFC 3339 explícito.
</Warning>

Filtros são de igualdade exata — não há correspondência parcial nem por prefixo. Uma data inválida é descartada e aquele filtro simplesmente não se aplica, um `limit` inválido cai para `50`, e parâmetros desconhecidos são ignorados. Nenhum desses casos devolve erro, então valide no cliente se isso importar.

Os resultados são ordenados por data de criação, do mais recente para o mais antigo. A ordenação não é configurável.

## Response `200 OK`

Cada item em `results` tem o mesmo formato do response de [Consultar Offramp](/pt/api-reference/offramps/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/offramps?limit=20&offset=0" \
    -H "api-key: <key>"
  ```

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

  response = requests.get(
      "https://checkout.noxpay.io/v2/offramps",
      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/offramps?${params}`,
    { headers: { "api-key": "<key>" } }
  );
  const data = await response.json();
  ```
</RequestExample>

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