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

# Paginação

> Estratégias de paginação nas APIs do DEVMOB

As APIs do DEVMOB suportam duas estratégias de paginação. O tipo utilizado depende do endpoint.

## Page-Based

Paginação tradicional com offset. Ideal para listagens com navegação por páginas.

### Parâmetros

| Parâmetro | Tipo     | Padrão | Descrição                |
| --------- | -------- | ------ | ------------------------ |
| `limit`   | `number` | `10`   | Itens por página (1–100) |
| `page`    | `number` | `1`    | Número da página (≥ 1)   |

### Resposta

```json theme={null}
{
  "data": [],
  "meta": {
    "limit": 10,
    "page": 1,
    "totalItems": 142,
    "totalPages": 15
  }
}
```

## Cursor-Based

Paginação baseada em cursor. Ideal para listagens com scroll infinito ou datasets grandes.

### Parâmetros

| Parâmetro        | Tipo      | Padrão | Descrição                   |
| ---------------- | --------- | ------ | --------------------------- |
| `limit`          | `number`  | `10`   | Itens por página (1–100)    |
| `nextCursor`     | `string?` | —      | Cursor para próxima página  |
| `previousCursor` | `string?` | —      | Cursor para página anterior |

### Resposta

```json theme={null}
{
  "data": [],
  "meta": {
    "hasMore": true,
    "limit": 10,
    "nextCursor": "123"
  }
}
```

`nextCursor` é incluído quando há mais itens; use-o como `nextCursor` na próxima requisição.