> For AI agents: the complete documentation index is available at https://developers.orbita.nexxo.tec.br/llms.txt, the full documentation bundle is available at https://developers.orbita.nexxo.tec.br/llms-full.txt.

# Paginação e filtros

## Formato das coleções

Listagens de projetos e issues retornam o envelope:

```json
{
  "items": [],
  "total": 0,
  "page": 1,
  "pageSize": 20
}
```

`total` é o total de itens encontrados; `page` começa em 1. O padrão do controller público é `page=1` e `pageSize=20`. Não existe cursor neste envelope.

Percorra páginas até atingir `total` ou receber uma página vazia. Como os dados podem mudar durante a leitura, deduplique os itens pelo UUID se precisar montar um catálogo local.

## Filtros públicos

| Operação                    | Query parameters                          |
| --------------------------- | ----------------------------------------- |
| Listar projetos             | `page`, `pageSize`                        |
| Listar issues de um projeto | `stateId`, `priority`, `page`, `pageSize` |

`stateId` é o UUID do estado. `priority` usa `None`, `Low`, `Medium`, `High` ou `Urgent`. Issues arquivadas não são incluídas por essa listagem pública.

A API privada e o MCP oferecem filtros adicionais. Não envie filtros de responsáveis, labels, texto ou datas à API pública esperando o mesmo comportamento: eles não são recebidos por seu controller atual.

## Identificadores

`organizationId`, `projectId` e `id` são UUIDs. `key`, como `ORB-42`, é uma identificação legível calculada pelo servidor. Preserve os dois quando sua integração precisar consultar e mostrar o trabalho.
