List a webhook's deliveries

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

GET /webhooks/{id}/deliveries

curl -X GET 'https://www.unitpost.com/api/v1/webhooks/wh_123/deliveries' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'User-Agent: my-app/1.0'

Response · 200

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "webhook_delivery",
      "id": "id_123",
      "svix_id": "svix_123",
      "webhook_id": "webhook_123",
      "event_id": "event_123",
      "event_type": "string",
      "status": "pending",
      "attempt": 0,
      "response_status": 0,
      "error": "string",
      "scheduled_at": "2026-01-01T00:00:00.000Z",
      "next_attempt_at": "2026-01-01T00:00:00.000Z",
      "delivered_at": "2026-01-01T00:00:00.000Z",
      "event_created_at": "2026-01-01T00:00:00.000Z",
      "data": {}
    }
  ]
}

The endpoint's delivery log, newest first and cursor-paginated: one row per event delivered (or being delivered) to it, with its status, attempts, your endpoint's last HTTP status and error, and the event's type and data. Use it to see why deliveries fail; Send a test event probes the endpoint without adding a row. Requires the webhooks:read capability.

Parameters4 fields

Field	Type	Description
`id`required	string · path	—
`limit`	integer · query	Max rows to return (default 20, max 100).
`after`	string · query	Return rows after this id (forward paging).
`before`	string · query	Return rows before this id (backward paging).

Response · 200 fields15 fields

Field	Type	Description
`object`required	enumwebhook_delivery	—
`id`required	string	The delivery id (`msg_…`).
`svix_id`required	string	The `svix-id` header this delivery's requests carried; retries reuse it, so dedupe on it.
`webhook_id`required	string	—
`event_id`required	string	The event (`evt_…`). The delivered payload's `event_id` is the same id without the `evt_` prefix.
`event_type`required	string	—
`status`required	enumpending \| queued \| retrying \| succeeded \| failed \| exhausted	`queued`: held while the endpoint is disabled. `retrying`: an attempt failed and another is scheduled at `next_attempt_at`. `exhausted`: every retry failed.
`attempt`required	integer	Attempts made so far.
`response_status`required	integer	Your endpoint's last HTTP status, or null before an attempt or on a network error.
`error`required	string	—
`scheduled_at`required	string	—
`next_attempt_at`required	string	—
`delivered_at`required	string	—
`event_created_at`required	string	—
`data`required	object	The event's `data`, as delivered.

200401403404422

List a webhook's deliveries

List a webhook's deliveries

Search docs and guides