Sudrel API
Painel Criar chave de API

Documentação › Notificações

Guias

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