List webhook deliveries

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

GET /api/v1/webhook_endpoints/{webhook_endpoint_id}/deliveries

cURL

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"

Response

{
  "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
}

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.

cURL

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"

Response

{
  "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.