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

# Paginação

> Listar Notas página a página, por cursor.

`GET /v1/notas` devolve as Notas das mais recentes para as mais antigas, em páginas:

```bash theme={null}
curl "$NOTASX/v1/notas?limite=50" -H "Authorization: Bearer $CHAVE"
```

```json theme={null}
{
  "itens": [ { "id": "ec73f621-…", "status": "emitida" } ],
  "proximo_cursor": "5b1e9a02-…"
}
```

Para a página seguinte, passe o `proximo_cursor` em `cursor`. Repita até ele vir `null`:

```bash theme={null}
curl "$NOTASX/v1/notas?limite=50&cursor=5b1e9a02-…" -H "Authorization: Bearer $CHAVE"
```

| Parâmetro | Padrão | Descrição |
| - | - | - |
| `limite` | `50` | Notas por página, de 1 a 100. |
| `cursor` | | O `proximo_cursor` da página anterior. |
| `prestador_id` | | Só as Notas deste Prestador. |
| `status` | | Só as Notas neste status (ex.: `falhou`). |

Notas criadas enquanto você pagina aparecem no topo da primeira página e não deslocam as páginas seguintes:
nada se repete nem some.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.