Documentação › Notificações
Eventos
O log de eventos da conta, por cursor, com 90 dias de retenção.
O log de eventos da conta: todo evento, com ou sem webhook, em ordem.
Leia com GET /v1/eventos?apos=<cursor> e guarde o proximo_cursor de
cada resposta (ele vem mesmo quando a página está vazia). Os eventos vêm em
ordem, e o cursor só avança; nunca use data para paginar.
O cursor é um texto opaco: guarde e devolva exatamente como veio, sem
interpretar. O seq de cada evento é o mesmo tipo de cursor. Até 02/10/2026
ele era um número; um cursor numérico guardado antes disso continua aceito em
apos.
Sem apos, a leitura começa no evento mais antigo ainda guardado. Filtre por
tipo com tipos (separados por vírgula). Cada evento traz id (o mesmo
X-Sudrel-Event-Id do webhook), tipo, ocorrido_em, ambiente,
empresa_id, recurso (tipo, id e url para ler o estado atual) e
dados.
dados vem preenchido quando o corpo foi guardado (havia webhook
assinando o tipo, e sempre nos documentos recebidos); senão é null e
recurso.url diz onde ler o estado atual.
Retenção: 90 dias. Cursor mais velho do que isso responde 410
cursor_vencido, com cursor_mais_antigo: continue a partir dele e
confira pelas rotas de leitura o que pode ter mudado no intervalo.
Rotas desta seção, com teste na página
- GET/v1/eventos · Log de eventos da conta, por cursor