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

# Paginação

> limit e page nas listagens.

As listagens aceitam dois parâmetros:

| Parâmetro | Padrão | Máximo | Descrição              |
| --------- | ------ | ------ | ---------------------- |
| `limit`   | 25     | 100    | Itens por página       |
| `page`    | 1      | —      | Página, começando em 1 |

```bash theme={null}
curl "https://api.weve.cx/v1/clubs/5a4f2c56-…/students?limit=50&page=2" \
  -H "Authorization: Bearer $TOKEN"
```

## Valor inválido não quebra a listagem

`limit=9999` é reduzido ao teto de 100, e `page=-3` cai na primeira página: valor fora da
faixa é ajustado, não recusado — o pior desfecho para quem consome uma listagem é ela falhar
por causa de um parâmetro de navegação. Só o que não é número (`limit=abc`) responde `400`
com `invalid_param`, porque aí não há o que ajustar.

<Note>
  A resposta ainda não traz o total de itens, então não há como calcular o número de páginas.
  Enquanto isso não existir, pagine até receber menos itens que o `limit` pedido.
</Note>


## Related topics

- [Histórico de eventos](/api-reference/webhooks/events-list.md)