List webhook endpoint deliveries

An endpoint that was not a target of an event has no row for it: a project-scoped endpoint records nothing for another project’s events. An empty list therefore means either nothing matched or nothing happened. To tell them apart, check the project’s own activity first: activity there with no delivery here is a defect to report; none there means there was nothing to deliver.

Delivery attempts for one webhook endpoint, newest first. One row per (endpoint, event, resource), updated in place across retries. Each row includes the exact request payload and signed headers Speechify sent (`request_body`, `request_headers`) and the response your server returned (`last_status_code`, `last_response_body`, `last_response_headers`), so you can verify the signature and debug failures. Cursor-paginated: omit `cursor` for the first page; walk pages while `has_more` is true (default page size 50, max 200). An endpoint that was not a target of an event has no row for it: a project-scoped endpoint records nothing for another project's events. An empty list therefore means either nothing matched or nothing happened. To tell them apart, check the project's own activity first: activity there with no delivery here is a defect to report; none there means there was nothing to deliver.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

webhook_endpoint_idstringRequired

Webhook endpoint id (prefixed whe_…).

Query parameters

cursorstringOptional

Opaque pagination cursor from a previous response.

limitintegerOptional1-200Defaults to 50

Max items per page (default 50, max 200).

Response headers

Speechify-Request-IdstringOptional

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends a Speechify-Request-Id request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests

it is the stable handle that ties your observation to Speechify’s server-side logs, and it matches the request_id field in the error envelope.

The legacy alias X-Request-ID carries the same value and is still accepted on requests, until 2027-07-24. Prefer the un-prefixed name (RFC 6648).

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends a `Speechify-Request-Id` request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests - it is the stable handle that ties your observation to Speechify's server-side logs, and it matches the `request_id` field in the error envelope. The legacy alias `X-Request-ID` carries the same value and is still accepted on requests, until 2027-07-24. Prefer the un-prefixed name (RFC 6648).

Response

The endpoint's delivery attempts.

next_cursorstring or null

Opaque keyset cursor for the next page. Pass back as the cursor request parameter. null when the caller has reached the end of the list (has_more is also false in that case).

has_moreboolean

True when more rows exist beyond this page.

deliverieslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error