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

# paginação

> a paginação na API é feita utilizando os parâmetros `skip` e `limit`, permitindo que o cliente controle quais e quantos registros deseja receber

## parâmetros

<ParamField query="skip" type="integer" default="0">
  define quantos registros devem ser ignorados antes de começar a retornar os resultados. o cálculo é feito com a fórmula `(página - 1) * limite`.
</ParamField>

<ParamField query="limit" type="integer" default="10">
  define a quantidade máxima de registros retornados por requisição. o máximo permitido é **50**.
</ParamField>

## exemplo

```bash theme={null}
GET /v1/orders?skip=10&limit=20
```

neste exemplo, a API ignora os 10 primeiros registros e retorna os próximos 20.

## paginação por cursor

além da paginação tradicional com offset, a API também suporta paginação baseada em cursor para endpoints que possuem o parâmetro `cursorId`. essa abordagem é mais eficiente em grandes volumes de dados.

<Tabs>
  <Tab title="por cursor">
    envie `cursorId` para paginar por cursor. para a primeira página, envie `cursorId = null`.
  </Tab>

  <Tab title="por offset">
    envie `skip` para paginar por offset. para a primeira página, envie `skip = 0` ou não envie nada.
  </Tab>
</Tabs>

<Warning>
  nunca envie `cursorId` e `skip` simultaneamente para evitar ambiguidades.
</Warning>