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

# GET /api/pix/cash-in

> Listar cash-ins com paginação, filtros de status e intervalo de datas (inclusivo, YYYY-MM-DD).

## Resumo

* **Método:** `GET`
* **Rota:** `/api/pix/cash-in`
* **Autenticação:** `Authorization: Bearer <seu_api_token>`

## Query (documentado)

| Parâmetro    | Padrão / máx.                | Uso                                                                               |
| ------------ | ---------------------------- | --------------------------------------------------------------------------------- |
| `page`       | default **1**                | Paginação.                                                                        |
| `limit`      | default **20**, máx. **100** | Tamanho da página.                                                                |
| `status`     | opcional                     | `PENDING`, `PAID`, `EXPIRED`, `FAILED` (também podem existir estados além disso). |
| `start_date` | opcional                     | Filtro **inclusivo** `YYYY-MM-DD`.                                                |
| `end_date`   | opcional                     | Filtro **inclusivo** `YYYY-MM-DD`.                                                |

> **Nota:** `PROVIDER_RESULT_UNKNOWN` e `RECONCILIATION_REQUIRED` podem aparecer no **detalhe** (`GET /api/pix/cash-in/{id}`) mesmo que não sejam o foco dos filtros de lista (texto de origem).

`TODO: resposta (envelope, total de itens, links de paginação)` — a origem não traz o JSON do array.

## HTTP

* **200** OK.
* **401** Não autenticado.
* **500** Interno.

## Ver também

* [Criar cash-in](/api-reference/create-cash-in)
* [Obter detalhe](/api-reference/get-cash-in)