Pagination

Endpoints que retornam listas usam paginação por cursor. É mais eficiente que offset, e estável mesmo quando dados são adicionados durante a paginação.

Parâmetros

limit — número máximo de itens por página (padrão 25, máximo 100)
cursor — cursor da próxima página (vem na resposta anterior)

Exemplo

Primeira página

GET /v1/contacts?limit=25

Response

{
  "data": [
    { "id": "ct_001", "name": "Ana" },
    { "id": "ct_002", "name": "Bruno" }
  ],
  "pagination": {
    "limit": 25,
    "has_more": true,
    "next_cursor": "ct_002:2026-05-15T10:30:00Z"
  }
}

Próxima página

GET /v1/contacts?limit=25&cursor=ct_002:2026-05-15T10:30:00Z

Quando parar

Continue chamando enquanto pagination.has_more for true. Quando ficar false, você chegou no fim da lista.