List an organization webhook's deliveries
GET/api/v1/organizations/{id}/webhooks/{webhook_id}/deliveries
curl -X GET 'https://www.unitpost.com/api/v1/organizations/org_123/webhooks/wh_123/deliveries' \
-H 'Authorization: Bearer YOUR_ORG_KEY' \
-H 'User-Agent: my-app/1.0'{
"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": {},
"workspace_id": "workspace_123",
"external_id": "external_123"
}
]
}The endpoint's delivery log, newest first and cursor-paginated, as GET /webhooks/{id}/deliveries. Each row also names the event's workspace (workspace_id) and that workspace's external_id now. Narrow it with status, event_type, and one workspace by workspace_id or external_id. A filter value it can't apply (a typo, an unknown id) is ignored and named in the Unitpost-Warning header, and the answer is the one without it; send Unitpost-Strict: true to have it refused instead. A workspace_id or external_id it can't read (malformed, too long, sent twice) is not ignored: the page is empty, named in Unitpost-Warning, never every workspace's deliveries. Each row carries its event's data (message content of every workspace), so this takes organizations:write; a key with only organizations:read gets 403 insufficient_scope. Takes an organization key (ok_live_…) with organizations:write.
Parameters9 fields
| Field | Type | Description |
|---|---|---|
idrequired | string · path | The organization's id (`org_…`), from `GET /whoami` or Organization → API. |
webhook_idrequired | string · path | The organization webhook endpoint's id (`wh_…`). |
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). |
status | string · query | One or more delivery statuses, comma-separated: `pending`, `queued`, `retrying`, `succeeded`, `failed`, `exhausted`. |
event_type | string · query | Only deliveries of this event type, e.g. `email.bounced`. |
workspace_id | string · query | Only events of this workspace (`ws_…`). |
external_id | string · query | Only events of the workspace with this `external_id`. |
Response · 200 fields17 fields
| Field | Type | Description |
|---|---|---|
objectrequired | enumwebhook_delivery | — |
idrequired | string | The delivery id (`msg_…`). |
svix_idrequired | string | The `svix-id` header this delivery's requests carried; retries reuse it, so dedupe on it. |
webhook_idrequired | string | — |
event_idrequired | string | The event (`evt_…`). The delivered payload's `event_id` is the same id without the `evt_` prefix. |
event_typerequired | string | — |
statusrequired | 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. |
attemptrequired | integer | Attempts made so far. |
response_statusrequired | integer | Your endpoint's last HTTP status, or null before an attempt or on a network error. |
errorrequired | string | — |
scheduled_atrequired | string | — |
next_attempt_atrequired | string | — |
delivered_atrequired | string | — |
event_created_atrequired | string | — |
datarequired | object | The event's `data`, as delivered. |
workspace_idrequired | string | The workspace the event happened in (`ws_…`). |
external_idrequired | string | That workspace's `external_id` now (the delivered envelope carried the one at delivery time); null when it has none. |