DocsAPI referenceWebhooks

List webhook deliveries

The newest first, a page at a time: pass next_cursor as cursor for the next page.

GET /v1/webhook-deliveries

Needs an API key: Authorization: Bearer $VIDEXO_API_KEY.

Parameters

Parameters
Name	In	Type	Description
`limit`	query	integer, 1 to 100	Deliveries per page, 1 to 100.
`cursor`	query	string, up to 200 characters	The `next_cursor` of the previous page.

Request

bash

curl "$VIDEXO_API_URL/v1/webhook-deliveries?limit=20" \
  -H "Authorization: Bearer $VIDEXO_API_KEY"

JavaScript

const response = await fetch(`${process.env.VIDEXO_API_URL}/v1/webhook-deliveries?limit=20`, {
  headers: { Authorization: `Bearer ${process.env.VIDEXO_API_KEY}` },
});
const deliveries = await response.json();

Response

200 JSON

{
  "data": [
    {
      "id": "msg_5d0c8f7a1b2e4c6d9e0f1a2b",
      "job_id": "job_3k9x0c2mfq8w1n7r5t4b6v2z",
      "event_type": "job.succeeded",
      "target": "endpoint",
      "endpoint_id": "we_4n8c2kq0x7m1v5z3b9r6t0wa",
      "url": "https://example.com/hooks/videxo",
      "status": "delivered",
      "attempts": 1,
      "max_attempts": 8,
      "next_attempt_at": null,
      "last_attempt_at": "2026-11-04T12:01:10.000Z",
      "last_status_code": 204,
      "last_error": null,
      "last_duration_ms": 182,
      "last_response_body": "",
      "delivered_at": "2026-11-04T12:01:10.000Z",
      "created_at": "2026-11-04T12:01:09.000Z"
    }
  ],
  "next_cursor": null
}

Responses

Responses
Status	Body	When
200	WebhookDeliveryList	One page of deliveries.
400	Problem	invalid_request
401	Problem	authentication_failed (missing_api_key, invalid_api_key, api_key_revoked, api_key_expired)
403	Problem	permission_denied (token_scope): a client token cannot call this route
429	Problem	rate_limited, with Retry-After in seconds