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

# Paginação

> Como percorrer uma lista página por página.

Cada lista devolve uma página por vez, do item mais novo ao mais antigo.

## Os parâmetros

| Parâmetro | O que faz                                                   |
| --------- | ----------------------------------------------------------- |
| `limit`   | A quantidade de itens da página, de 1 a 100. O padrão é 25. |
| `cursor`  | O valor de `next_cursor` da página anterior.                |

## A resposta

```json theme={null}
{
  "data": [],
  "has_more": true,
  "next_cursor": "WyIyMDI2LTA5LTI1VDEzOjAwOjAwLjAwMDAwMFoiLDEyXQ"
}
```

* `data` traz os itens da página.
* `has_more` diz se a lista tem mais itens depois desta página.
* `next_cursor` abre a próxima página. Na última página, o valor é `null`.

## Como percorrer a lista inteira

1. Chame a lista sem `cursor`.
2. Leia os itens de `data`.
3. Se `has_more` for `true`, chame a lista de novo com `cursor` igual a `next_cursor`. Repita os mesmos filtros.
4. Pare quando `has_more` for `false`.

## As regras do cursor

* Trate o cursor como um texto opaco. Nunca monte nem altere um cursor.
* Um cursor alterado recebe `400` com o código `invalid_parameter`.
* Um `limit` fora de 1 a 100 recebe `400` com o código `invalid_parameter`.
* Um item novo não muda as páginas seguintes. O seu sistema recebe cada item uma vez só, e nenhum item antigo fica de fora.
* O item novo aparece na primeira página, na próxima vez que o seu sistema percorrer a lista.