Histórico de entregas

GET /webhooks/{id}/deliveries

Histórico de entregas de um webhook, mais recentes primeiro. Use para auditar o que foi
entregue, diagnosticar falhas e reconciliar eventos que seu sistema não processou.

Query params — todos opcionais exceto onde indicado.

Param	Tipo	Default	Descrição
`status`	string	—	Filtra por status da entrega (ver tabela abaixo)
`from`	string	—	Início da janela de tempo (timestamp ISO 8601)
`to`	string	—	Fim da janela de tempo (timestamp ISO 8601)
`cursor`	string	—	Posição de paginação — opaco, não interprete nem construa
`limit`	integer	`20`	Itens por página, entre 1 e 100

Sucesso — 200 OK

{
  "items": [
    {
      "id": "7c6d5e4f-...",
      "eventId": "3f2a1b9c-...",
      "eventType": "contract.signature.finished",
      "status": "SUCCEEDED",
      "attempts": 1,
      "lastHttpStatus": 200,
      "lastError": null,
      "createdAt": "2026-09-16T12:34:56Z",
      "updatedAt": "2026-09-16T12:34:57Z"
    }
  ],
  "cursors": {
    "self": "/webhooks/c4d5e6f7-8901-2345-6789-abcdef012345/deliveries?limit=20",
    "first": "/webhooks/c4d5e6f7-8901-2345-6789-abcdef012345/deliveries?limit=20",
    "next": "/webhooks/c4d5e6f7-8901-2345-6789-abcdef012345/deliveries?cursor=eyJ...&limit=20"
  }
}

`items[].status`	Significado
`PENDING`	Enfileirada, ainda não entregue
`SUCCEEDED`	Entregue com resposta 2xx
`FAILED`	Última tentativa falhou; ainda dentro da janela de retentativas
`EXHAUSTED`	Esgotou as retentativas — não será mais tentada
`DISCARDED`	Descartada sem tentativa (ex.: webhook suspenso antes da entrega)

Paginação (ADR Global 0001): siga cursors.next até ele não vir mais — sua ausência marca a
última página. cursors.prev e cursors.last não existem: a navegação é em uma direção só.

Erros mapeados

HTTP	`code`	Quando ocorre
400	`WEBHOOK_INVALID_DELIVERY_CURSOR`	Cursor malformado ou não emitido por esta API
400	`WEBHOOK_INVALID_DELIVERY_FILTER`	`status`, `from`, `to` inválidos, ou `limit` fora de 1–100
404	`WEBHOOK_NOT_FOUND`	Webhook não existe ou pertence a outro parceiro
500	`WEBHOOK_INTEGRATION_FAILURE`	Falha de comunicação interna — repetir com backoff