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

# Paginação de Listagens

Todos os endpoints da API que retornam listas são paginados. Para controlar a navegação entre páginas, utilize os seguintes parâmetros de query:

<ResponseField name="page" type="number" default={1}>
  Número da página a ser carregada (iniciando em 1).
</ResponseField>

<ResponseField name="pageSize" type="number" default={10}>
  Quantidade de itens por página.
</ResponseField>

A resposta da requisição incluirá também no corpo da resposta um campo chamado `totalRecords`, que informa o total de registros da consulta. Esse campo permite calcular o total de páginas e implementar a navegação completa.

## Exemplo de resposta

```json theme={null}
{
  "data": [
    {"id": "9fae8209-b4b6-441f-8606-5328c27f7ef6", "name": "Insight Academy"},
    {"id": "97cd6954-b6fa-47bf-9199-7354459a7345", "name": "Insight Academy API"},
  ],
  "totalRecords": 50
}
```