Paginação

As listagens que crescem sem limite são paginadas por cursor: a de eventos e a de mensagens de uma fonte.

curl "https://api.notyfacil.com.br/v1/events?limit=50" \
  -H "Authorization: Bearer $NOTYFACIL_KEY"

{
  "items": [ { "id": "evt_01JB8XZQ4T9M2NKPWV3RYCF7HD", "type": "pedido.pago", "consumer": "cliente-42", "deliveries": 2, "createdAt": "2026-09-10T12:00:00Z" } ],
  "nextCursor": "NjM4OTU2MDMyMDAwMDAwMDAwfDAxSkI4WFpRNFQ5TTJOS1BXVjNSWUNGN0hE"
}

Para a página seguinte, devolva o nextCursor em cursor, com os mesmos filtros:

curl "https://api.notyfacil.com.br/v1/events?limit=50&cursor=NjM4OTU2MDMyMDAwMDAwMDAwfDAxSkI4WFpRNFQ5TTJOS1BXVjNSWUNGN0hE" \
  -H "Authorization: Bearer $NOTYFACIL_KEY"

Quando a resposta vem sem nextCursor, acabou.

As regras

• A ordem é do mais recente para o mais antigo, e é estável: um item publicado durante a varredura não aparece repetido nem desloca os seguintes.
• O cursor é opaco. Não monte nem interprete um; ele pode mudar de formato. Um cursor inválido responde 422.
• limit vai de 1 a 100 em eventos e de 1 a 200 em mensagens. O padrão é 50 nas duas.

Listagens com teto

As outras listagens não são paginadas: devolvem os itens mais recentes até um teto fixo.

Listagem	Teto
GET /v1/consumers	100
GET /v1/endpoints	100
GET /v1/events/{id}/deliveries	100
GET /v1/ingest/sources	200
GET /v1/event-types	sem teto