API ReferenceWebhooksEndpoints

List webhook endpoint deliveries

Beta
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).

Authentication

AuthorizationBearer

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

Path parameters

webhook_endpoint_idstringRequired

Webhook endpoint id (prefixed whe_…).

Headers

Speechify-VersionstringOptional

Query parameters

cursorstringOptional
Opaque pagination cursor from a previous response.
limitintegerOptional1-200Defaults to 50

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

Response headers

X-Request-IDstring
Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends an `X-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.

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