---
title: "List an organization webhook's deliveries"
description: "The endpoint's delivery log, newest first and cursor-paginated, as GET /webhooks/{id}/deliveries. `GET /api/v1/organizations/{id}/webhooks/{webhook_id}/deliveries`"
url: https://www.unitpost.com/docs/platform/get-organizations-id-webhooks-webhook-id-deliveries
section: "Platform API reference"
updated: 2026-11-17
---
# List an organization webhook's deliveries

`GET /api/v1/organizations/{id}/webhooks/{webhook_id}/deliveries`

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`.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes | The organization's id (`org_…`), from `GET /whoami` or Organization → API. |
| `webhook_id` | path | string | yes | The organization webhook endpoint's id (`wh_…`). |
| `limit` | query | integer | no | Max rows to return (default 20, max 100). |
| `after` | query | string | no | Return rows after this id (forward paging). |
| `before` | query | string | no | Return rows before this id (backward paging). |
| `status` | query | string | no | One or more delivery statuses, comma-separated: `pending`, `queued`, `retrying`, `succeeded`, `failed`, `exhausted`. |
| `event_type` | query | string | no | Only deliveries of this event type, e.g. `email.bounced`. |
| `workspace_id` | query | string | no | Only events of this workspace (`ws_…`). |
| `external_id` | query | string | no | Only events of the workspace with this `external_id`. |

## Response fields (200)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `object` | enum | yes | One of: `webhook_delivery`. |
| `id` | string | yes | The delivery id (`msg_…`). |
| `svix_id` | string | yes | The `svix-id` header this delivery's requests carried; retries reuse it, so dedupe on it. |
| `webhook_id` | string | yes | — |
| `event_id` | string | yes | The event (`evt_…`). The delivered payload's `event_id` is the same id without the `evt_` prefix. |
| `event_type` | string | yes | — |
| `status` | enum | yes | `queued`: held while the endpoint is disabled. `retrying`: an attempt failed and another is scheduled at `next_attempt_at`. `exhausted`: every retry failed. One of: `pending`, `queued`, `retrying`, `succeeded`, `failed`, `exhausted`. |
| `attempt` | integer | yes | Attempts made so far. |
| `response_status` | integer | yes | Your endpoint's last HTTP status, or null before an attempt or on a network error. |
| `error` | string | yes | — |
| `scheduled_at` | string | yes | — |
| `next_attempt_at` | string | yes | — |
| `delivered_at` | string | yes | — |
| `event_created_at` | string | yes | — |
| `data` | object | yes | The event's `data`, as delivered. |
| `workspace_id` | string | yes | The workspace the event happened in (`ws_…`). |
| `external_id` | string | yes | That workspace's `external_id` now (the delivered envelope carried the one at delivery time); null when it has none. |

## Responses

| Status | Description |
| --- | --- |
| 200 | A page of deliveries. |
| 401 | Missing or invalid organization key (a workspace key is refused). |
| 403 | API access not approved for the organization, the key lacks the capability, or no User-Agent. |
| 404 | Not this key's organization, or not one of its webhook endpoints (a workspace's endpoint is a 404 here). |
| 422 | Invalid pagination params, or with `Unitpost-Strict: true` a filter value. |
| 429 | The organization's rate limit. |
| 503 | `operation_timed_out`: a filtered read took too long; retry after `Retry-After`. |

## Example request

```bash
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'
```

## Example response (200)

```json
{
  "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"
    }
  ]
}
```

## Links

- HTML reference (with Node.js, Python, Ruby, PHP, Laravel, Go, Java, Rust, .NET and CLI examples): https://www.unitpost.com/docs/platform/get-organizations-id-webhooks-webhook-id-deliveries
- OpenAPI 3.1 (full schemas): https://www.unitpost.com/api/v1/openapi.json
