List delivery failures
Error handling
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//failures/.
- Download the HAR when needed for deep HTTP-level debugging.
GET
List delivery failures
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Identifier of the webhook endpoint to inspect
Query Parameters
Maximum number of failures to return. Defaults to 20.
Required range:
1 <= x <= 100Response
Webhook delivery failures
Response containing a list of webhook delivery failures for a specific webhook endpoint.
Collection of recorded webhook delivery failures