Sign in

v14

OpenAPI 3.1.02026-08-03122113375.9 KB
seller-webhooks

Retrieve webhook failure

Retrieve detailed metadata for one recorded delivery failure.

Use this endpoint after listing failures to inspect a specific failed attempt in detail.

The response provides failure-level diagnostics including:

  • Receiver HTTP status code.
  • Delivery latency.
  • Failure reason.
  • Timestamp and HAR key reference.

Behavior notes:

  • Returns 404 if the webhook is not found for the seller.
  • Returns 404 if the specified failure id is not associated with that webhook.

For full request/response trace data, call the HAR download endpoint for the same failure id.

get/seller/webhooks/{webhookId}/failures/{failureId}

Path parameters

webhookIdstring required

Identifier of the webhook endpoint that experienced the failure

Identifier of the webhook endpoint that experienced the failure

failureIdstring required

Identifier of the failure to retrieve

Identifier of the failure to retrieve

Response

Webhook delivery failure

idstring required

Unique identifier for the webhook failure

responseStatusCodeinteger required

HTTP response status code returned by the endpoint

responseTimeinteger required

Time taken for the endpoint to respond in milliseconds

reasonstring required

Reason describing why the delivery failed

harKeystring required

Key for the HAR payload stored within the R2 bucket

createdAtstring date-time required

Timestamp when the failure was recorded