> ## Documentation Index
> Fetch the complete documentation index at: https://wordsmithai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List webhook deliveries

> List an endpoint's deliveries, newest first, with each one's latest attempt.

A delivery is one event sent to one endpoint. It stays `pending` while retries remain, and ends `delivered` or `failed`. Deliveries are kept for 30 days.

## Authentication

Requires an API key, or an OAuth token with `webhooks:read`.

## Path parameters

**webhook\_endpoint\_id** `string` *required*

The endpoint.

## Query parameters

**status** `string`

Only deliveries in this status: `pending`, `delivered` or `failed`.

**cursor** `string`

The `cursor` from the previous page.

**limit** `integer` (default: 50)

Deliveries per page, from 1 to 100.

## Response

Returns a page of deliveries.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.wordsmith.ai/api/v1/webhook_endpoints/0e7b3c5a-9d21-4f86-b4a0-6c8e2f1d7a39/deliveries?status=failed" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"
```

```json Response theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "items": [
    {
      "id": "2a6c8e0f-1b3d-4f57-9a2c-4e6f8a0b2c4d",
      "event_id": "8d2f4a61-3c7e-4b09-a5d1-9e6f0b2c7a48",
      "event_type": "task.assigned",
      "status": "failed",
      "attempts": 6,
      "next_attempt_at": null,
      "last_attempt": {
        "at": "2026-11-12T10:12:04Z",
        "delivered": false,
        "response_status": 503,
        "error_code": "http_error"
      },
      "created_at": "2026-11-09T10:12:03Z"
    }
  ],
  "cursor": null
}
```

## Errors

| Status | `error_code` | When |
| - | - | - |
| 400 | `bad_request` | An unknown `status`, or a `cursor` this API did not return. |
| 404 | `resource_not_found` | No endpoint with this id that you can manage, or webhooks are not on for your organisation. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.