GET/org/webhook/{webhook_id}/history

Get webhook delivery history

Retrieves delivery history for a webhook. Use the webhook ID to inspect event names, delivery statuses, retry counts, asset IDs, and event timestamps.

1 parameter
webhook_idstringrequired

Webhook ID whose delivery history to retrieve; you can obtain it from the webhook listing.

5 status codes
200Returns an array of webhook event records containing each event's ID, delivery status, retry count, event name, associated asset ID, and creation timestamp.
asset_idstringrequired

Asset ID for which the event was fired

created_atstringrequired

Event timestamp in ISO 8601 format

eventstringrequired

Webhook event name. One of the video status, live video status, or product events.

Allowed:video.status.createdvideo.status.downloadedvideo.status.optimizedvideo.status.readyvideo.status.erroredvideo.status.deletedvideo.status.repackagedvideo.status.stream_readylive.video.status.createdlive.video.status.readylive.video.status.preparinglive.video.status.connected
idstringrequired

Webhook event ID

retry_countintegerrequired

Number of retries it needed to deliver webhook.

statusstringrequired

Delivery status stored for the event: success, retrying, or failed. success means the endpoint returned a 2xx response. retrying means that attempt did not.

400Returned when the request is invalid.

One documented failure

  • webhook_id_not_valid

    The webhook is not valid.

errorobjectrequired
401Returned when the API key or bearer token is missing or invalid.

One documented failure

  • invalid_api_key

    API key supplied with request is invalid

errorobjectrequired
403Returned when the account has unpaid dues or the authenticated user lacks the required role permissions.

One documented failure

  • unauthorized

    You don't have access to this feature. Please contact your organization owner.

errorobjectrequired
404Returned when the requested webhook is not found.

One documented failure

  • webhook_not_found

    Could not find any webhook with the specified webhook_id.

errorobjectrequired

Error handling

A 400 is returned when the request is invalid. A 401 is returned when the API key or bearer token is missing or invalid. A 403 is returned when the account has unpaid dues or the authenticated user lacks the required role permissions. A 404 is returned when the webhook is not found; the webhook_id path parameter must identify an existing webhook.