List webhook deliveries
const url = 'https://optlo.com/api/v1/webhooks/example/deliveries?limit=50';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://optlo.com/api/v1/webhooks/example/deliveries?limit=50' \ --header 'Authorization: Bearer <token>'Lists delivery metadata and recorded attempts, newest deliveries first, for an existing workspace subscription. History expires 30 days after delivery creation. Event contents, signing secrets, and response bodies are excluded. An attempt with error unknown has no confirmed outcome; the recipient may have received it. runAt is the next scheduled retry or queue/request lease expiry. Attempts made before attempt history was introduced are not reconstructed.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Unique identifier for the webhook.
Query Parameters
Section titled “Query Parameters”Maximum number of resources to return on one page.
Opaque cursor from the preceding page. Bound to workspace, resource and filters; survives key rotation.
Response
Section titled “Response”Success
Show child attributes
Resources on this page.
Show child attributes
Unique identifier for the delivery.
ID of the webhook subscription receiving the event.
ID of the event being delivered.
Type of event being delivered.
Current delivery state. succeeded means the endpoint accepted the event; failed and canceled are terminal.
Number of delivery attempts started.
Whether delivery was triggered automatically or by a manual replay.
Time delivery was most recently requested.
Next scheduled retry or queue/request lease expiry. Null when no further work is scheduled.
Time the delivery was created.
Time the delivery reached a terminal state. Null while pending.
HTTP status from the latest recorded response.
Latest recorded failure reason, or null when no error was recorded.
Recorded HTTP attempts for this delivery. Older attempts may be absent from history.
Show child attributes
ID of the delivery this attempt belongs to.
Attempt number, starting at 1.
Time the attempt started.
Time the attempt finished. Null if completion was not recorded.
Duration of the attempt in milliseconds, if recorded.
HTTP status returned by the endpoint, if a response was received.
Failure reason, or null when no error was recorded. unknown means the outcome could not be confirmed.
Pass this cursor to retrieve the next page. Null when no further page is available. When polling events in ascending order, retain the cursor even on empty pages.
Example
{ "data": [ { "id": "hook_mR9kL3xN6pB2vQ8z_B8kN4pR6xZ2.evnt_n5p8r2k6m4x9q3v7b1c0dfgh", "subscriptionId": "hook_mR9kL3xN6pB2vQ8z_B8kN4pR6xZ2", "eventId": "evnt_n5p8r2k6m4x9q3v7b1c0dfgh", "eventType": "message.created", "status": "succeeded", "attempt": 1, "trigger": "automatic", "requestedAt": "2026-10-13T09:10:00.100Z", "runAt": null, "createdAt": "2026-10-13T09:10:00.100Z", "completedAt": "2026-10-13T09:10:01.180Z", "responseStatus": 200, "error": null, "attempts": [ { "deliveryId": "hook_mR9kL3xN6pB2vQ8z_B8kN4pR6xZ2.evnt_n5p8r2k6m4x9q3v7b1c0dfgh", "attempt": 1, "startedAt": "2026-10-13T09:10:01.000Z", "completedAt": "2026-10-13T09:10:01.180Z", "durationMs": 180, "responseStatus": 200, "error": null } ] } ], "nextCursor": null}