Webhook deliveries

Retrieve a single delivery

Full single delivery row including the captured request body + headers (every attempt) and, for failed/dead attempts, the response body + headers. The list endpoints never carry these large fields.

get/api/v1/webhook-endpoints/{endpoint_id}/deliveries/{delivery_id}

Request

  • Base URL: https://api.sudomock.com
  • URL: https://api.sudomock.com/api/v1/webhook-endpoints/{endpoint_id}/deliveries/{delivery_id}
  • Auth: API key in header x-api-key

Path parameters

endpoint_idstring required

Id of the endpoint the delivery belongs to.

delivery_idstring required

Id of the delivery, as listed in the delivery log.

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.

request_bodystring nullable

The JSON body sent to your endpoint on the latest attempt.

request_headersstring nullable

Headers sent with the latest attempt, as a JSON string.

response_bodystring nullable

Body your endpoint returned on a failed or dead attempt.

response_headersstring nullable

Headers your endpoint returned on a failed or dead attempt, as a JSON string.

Example response

{
  "attempt": 2,
  "created_at": "2026-09-18T09:24:12.615000Z",
  "endpoint_id": "b5cd6284-f6a0-4cfc-94df-781353e30dfd",
  "event_type": "render.succeeded",
  "http_status": 500,
  "id": "3d682132-5477-4ffc-b33d-6e750c9c9f1f",
  "job_id": "4a4bfe21-d9d2-43a4-9877-b6ca4aec4349",
  "last_error": "non-2xx response: 500",
  "request_body": "{\"created_at\":\"2026-09-18T09:24:11.482713+00:00\",\"error\":null,\"event\":\"render.succeeded\",\"job_id\":\"4a4bfe21-d9d2-43a4-9877-b6ca4aec4349\",\"kind\":\"render\",\"result_url\":\"https://cdn.sudomock.com/mockup-assets/renders/c315f78f-d2c7-4541-b240-a9372842de94/render_8f2c1d4e.webp\",\"status\":\"succeeded\"}",
  "request_headers": "{\"Content-Type\":\"application/json\",\"User-Agent\":\"SudoMock-Webhook/1.0\",\"X-SudoMock-Signature\":\"2b4ddbe7024e2e0e732fb27374c3e0dedda3dbf2392abe78e9785c836f54832b\",\"X-SudoMock-Timestamp\":\"1789723451\"}",
  "response_body": "Internal Server Error",
  "response_headers": "{\"content-type\":\"text/plain;charset=UTF-8\"}",
  "status": "failed",
  "updated_at": "2026-09-18T09:25:47.201000Z"
}

Changes

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