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

# Paginação

> Como os endpoints de listagem retornam os resultados uma página por vez

Os endpoints de listagem retornam os resultados em páginas. Cada resposta traz uma página de itens e um cursor que aponta para a próxima, para que você percorra uma lista longa sem pular nem repetir itens enquanto novos são criados.

Todo endpoint paginado funciona da mesma forma, e a página dele lista os parâmetros de consulta `limit` e `next`.

## Parâmetros de consulta

**limit** `integer` (default: 15)

Quantidade máxima de itens na página. Um endpoint pode definir seu próprio padrão ou máximo; quando define, a página dele mostra.

**next** `string`

Cursor da página desejada: o valor de `next` da resposta anterior. Omita para obter a primeira página.

## Resposta

Toda resposta paginada tem os mesmos dois campos:

```json theme={null}
{
  "items": [
    {
      "id": "43230779-2cfb-4525-a40c-77fbf15e68f0",
      "clientId": "prod-client-v2",
      "description": "ERP Integration",
      "status": "ACTIVE"
    }
  ],
  "next": "NmEzZjljMjFlNGIwN2Q1YThjMTJmM2U5"
}
```

**items** `object[]`

Os itens desta página, na ordem do endpoint. Cada item tem os campos documentados na página do endpoint (abreviados acima).

**next** `string | null`

Cursor da próxima página. `null` quando esta é a última página.

## Boas práticas

### Use tamanhos de página adequados

Escolha um `limit` que equilibre desempenho e usabilidade. Páginas menores funcionam bem em telas interativas, enquanto páginas maiores (centenas de itens) funcionam melhor para processamento em lote.

### Trate a paginação com cuidado

Peça outra página apenas enquanto `next` tiver um valor. Na última página ele é `null`, e as respostas não trazem a contagem total. Envie `next` de volta exatamente como recebeu, com os mesmos filtros e a mesma ordenação, sem montá-lo nem interpretá-lo.

### Considere os limites de requisição

Fique atento aos limites de requisição ao percorrer grandes volumes de dados. Espace as requisições ou processe em lotes quando precisar de muitas páginas.


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