v14
OpenAPI 3.1.02026-08-03122113375.9 KBseller-webhooks
List delivery failures
List recent delivery failures for a specific webhook endpoint.
Use this endpoint for operational triage when webhook deliveries are failing or when reliability metrics show regressions.
Query behavior:
- Supports an optional 'limit' parameter.
- If omitted, the endpoint returns up to 20 failures.
- Failures are returned in reverse chronological order (newest first).
Each failure includes:
- Response status code from the receiver endpoint.
- Response time in milliseconds.
- Failure reason.
- HAR storage key and timestamp.
Recommended incident workflow:
- Call this endpoint to identify the latest failing attempts.
- Open a specific failure via GET /seller/webhooks/{webhookId}/failures/{failureId}.
- Download the HAR when needed for deep HTTP-level debugging.
get/seller/webhooks/{webhookId}/failures
Path parameters
webhookIdstring required
Identifier of the webhook endpoint to inspect
Identifier of the webhook endpoint to inspect
Query parameters
limitinteger
Maximum number of failures to return. Defaults to 20.
Maximum number of failures to return. Defaults to 20.
Response
Webhook delivery failures