Paginação

Endpoints de listagem aceitam:

Parâmetro	Padrão	Limites	Descrição
`page`	`1`	de `1` a `1000`	Página desejada.
`page_size`	`20`	de `1` a `100`	Itens por página.

curl "https://seventyonepay.online/api/v1/payments?page=2&page_size=50" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

A resposta traz a lista em data e o estado da paginação em pagination:

{
  "success": true,
  "data": [],
  "pagination": { "page": 2, "page_size": 50, "page_count": 7, "total": 312 }
}

Parâmetros desconhecidos

Os endpoints validam os parâmetros de consulta: um nome que não existe (por exemplo per_page) é recusado com 422 VALIDATION_ERROR. Use sempre page_size.

Varrer volumes grandes

A paginação por página vai até a página 1000. Para percorrer volumes maiores, alguns endpoints (GET /payments e GET /ledger) aceitam o parâmetro cursor: use o valor de pagination.next_cursor da resposta anterior (quando enviado, page é ignorado). Como alternativa, filtre por período (from e to) para reduzir o conjunto.

Varrer volumes grandes​

Varrer volumes grandes