Event Logs#

An event log is a record of one inbound POST /relay request. Delivery status per destination is tracked separately, as a binding between an event log and a destination — this is what powers the “360 view” of a request’s full delivery outcome.

Authenticated with a management token.

List event logs#

GET /v0/event-logs

Paginated.

Query parameters

Parameter	Description
`filter[event][]`	Filter by one or more event type names

Response 200

{
  "limit": 25,
  "previous": null,
  "next": null,
  "data": [
    {
      "id": "...",
      "trace_id": "b3f1...-uuid",
      "auth_id": "...",
      "source_ip": "203.0.113.4",
      "payload": { "order_id": 4821, "total": 59.99 },
      "event": { "id": "...", "name": "order.placed" },
      "received_at": "2026-06-19T00:34:07.000+00:00",
      "created_at": "2026-06-19T00:34:07.000+00:00"
    }
  ]
}

Get an event log#

GET /v0/event-logs/{id}

Response 200 — same shape as an item in the list response above.

Errors: 404 if the event log doesn’t exist.

Delivery status for a request#

GET /v0/event-logs/{id}/destinations

The per-request 360 view — delivery status for every destination that was subscribed at the time this request came in. Paginated.

Response 200

{
  "limit": 25,
  "previous": null,
  "next": null,
  "data": [
    {
      "id": "...",
      "trace_id": "b3f1...-uuid",
      "status": "dispatched",
      "destination": { "id": "...", "name": "billing-webhook", "description": null },
      "event_log": {
        "id": "...",
        "payload": { "order_id": 4821, "total": 59.99 },
        "source_ip": "203.0.113.4",
        "received_at": "2026-06-19T00:34:07.000+00:00"
      },
      "attempted_at": "2026-06-19T00:34:08.120+00:00",
      "error": null,
      "created_at": "2026-06-19T00:34:07.000+00:00",
      "updated_at": "2026-06-19T00:34:08.000+00:00"
    }
  ]
}

status is pending, dispatched, or errored. error carries detail when status is errored, otherwise null.

Delivery history for a destination#

GET /v0/destinations/{id}/event-logs

The inverse view — every delivery attempt for one destination, across every event that ever matched it. Same response shape as above . Paginated.