/webhooks/{id}/deliveries

GET/v1/agent/webhooks/{id}/deliveries

List webhook delivery attempts

Requires API-key authentication (agentAuth, agentId).

Purpose: list delivery attempts for one outbound webhook endpoint.

Auth and scope: header-key auth or OAuth agent:read.

Idempotency: not required.

Path params:

json

example

{
  "id": "webhook endpoint uuid"
}

Query:

json

example

{
  "status": "delivered",
  "event_id": "uuid",
  "cursor": "uuid",
  "limit": 50
}

status, event_id, cursor, and limit are optional. cursor is a delivery UUID and is valid only for the same endpoint and active filters.

Response:

json

example

{
  "ok": true,
  "items": [
    {
      "id": "uuid",
      "event_id": "uuid",
      "event_type": "payment.executed",
      "event_created_at": "2026-05-16T00:00:00.000Z",
      "endpoint_id": "uuid",
      "attempt": 1,
      "status": "delivered",
      "http_status": 200,
      "error_class": null,
      "latency_ms": 120,
      "response_body": "ok",
      "next_attempt_at": null,
      "first_attempt_at": "2026-05-16T00:00:00.000Z",
      "last_attempt_at": "2026-05-16T00:00:00.000Z",
      "terminal_at": "2026-05-16T00:00:00.000Z",
      "created_at": "2026-05-16T00:00:00.000Z",
      "updated_at": "2026-05-16T00:00:00.000Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Common errors: not_found, validation_failed, insufficient_scope, rate_limited.

Related recipe: Verify a Webhook.