Webhook deliveries

Retrieve a list of events

Reverse-chron delivery log spanning every endpoint the caller owns. The response groups rows by (job_id, event_type) into events.

get/api/v1/webhook-endpoints/events

Request

  • Base URL: https://api.sudomock.com
  • URL: https://api.sudomock.com/api/v1/webhook-endpoints/events
  • Auth: API key in header x-api-key

Query parameters

statusstring

Keep only deliveries in this state, where failed also returns the ones marked dead.

event_typestring

Filter by event type. Either spelling of a photo-mockup event matches deliveries logged under the other.

cursorstring

Token from the previous page's X-Webhook-Next-Cursor response header; omit it to start from the newest delivery.

limitinteger

How many deliveries one page returns, with the rest reachable through the next page's cursor.

Response

Successful Response

idstring required

Unique identifier for this delivery.

endpoint_idstring required

Identifier of the webhook endpoint this delivery was sent to.

job_idstring required

Identifier of the job this event was raised for.

event_typestring required

Event type this delivery carries, such as render.succeeded.

statusstring required

Current state of this delivery, such as delivered or failed.

http_statusinteger nullable

HTTP status code your endpoint returned on the latest attempt.

attemptinteger required

Attempt counter for this delivery, rising with each retry.

last_errorstring nullable

Error recorded for the latest attempt.

created_atstring date-time required

Time this delivery was first recorded.

updated_atstring date-time nullable

Time this delivery was last updated.

Example response

[
  {
    "attempt": 0,
    "created_at": "2026-09-18T09:24:12.615000Z",
    "endpoint_id": "b5cd6284-f6a0-4cfc-94df-781353e30dfd",
    "event_type": "render.succeeded",
    "http_status": 200,
    "id": "3d682132-5477-4ffc-b33d-6e750c9c9f1f",
    "job_id": "4a4bfe21-d9d2-43a4-9877-b6ca4aec4349",
    "status": "delivered",
    "updated_at": "2026-09-18T09:24:12.983000Z",
    "last_error": null
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.