---
title: "Retrieve a list of events"
method: GET
path: "/api/v1/webhook-endpoints/events"
tags: ["Webhook deliveries"]
---

# Retrieve a list of 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`

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

## Query parameters

- `status` string: Keep only deliveries in this state, where failed also returns the ones marked dead.
- `event_type` string: Filter by event type. Either spelling of a photo-mockup event matches deliveries logged under the other.
- `cursor` string: Token from the previous page's X-Webhook-Next-Cursor response header; omit it to start from the newest delivery.
- `limit` integer: How many deliveries one page returns, with the rest reachable through the next page's cursor.

## Response `200`

Successful Response

- WebhookDeliveryResponse[]
  - `id` string, required: Unique identifier for this delivery.
  - `endpoint_id` string, required: Identifier of the webhook endpoint this delivery was sent to.
  - `job_id` string, required: Identifier of the job this event was raised for.
  - `event_type` string, required: Event type this delivery carries, such as render.succeeded.
  - `status` string, required: Current state of this delivery, such as delivered or failed.
  - `http_status` integer, nullable: HTTP status code your endpoint returned on the latest attempt.
  - `attempt` integer, required: Attempt counter for this delivery, rising with each retry.
  - `last_error` string, nullable: Error recorded for the latest attempt.
  - `created_at` string, date-time, required: Time this delivery was first recorded.
  - `updated_at` string, date-time, nullable: Time this delivery was last updated.

---

[API](https://skmtc.dev/sudomock/apis/sudomock-api.md) · [All operations](https://skmtc.dev/sudomock/apis/sudomock-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sudomock/apis/sudomock-api/revisions/c1cc24006c60?raw)