---
title: "List delivery failures"
method: GET
path: "/seller/webhooks/{webhookId}/failures"
tags: ["seller-webhooks"]
---

# List delivery failures

`GET /seller/webhooks/{webhookId}/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:

1. Call this endpoint to identify the latest failing attempts.
2. Open a specific failure via GET /seller/webhooks/{webhookId}/failures/{failureId}.
3. Download the HAR when needed for deep HTTP-level debugging.

## Path parameters

- `webhookId` string, required — Identifier of the webhook endpoint to inspect

## Query parameters

- `limit` integer — Maximum number of failures to return. Defaults to 20.

## Response `200`

Webhook delivery failures

- SellerWebhookFailureListResponse — Response containing a list of webhook delivery failures for a specific webhook endpoint.
  - `failures` SellerWebhookFailure[], required — Collection of recorded webhook delivery failures
    - `id` string, required — Unique identifier for the webhook failure
    - `responseStatusCode` integer, required — HTTP response status code returned by the endpoint
    - `responseTime` integer, required — Time taken for the endpoint to respond in milliseconds
    - `reason` string, required — Reason describing why the delivery failed
    - `harKey` string, required — Key for the HAR payload stored within the R2 bucket
    - `createdAt` string, date-time, required — Timestamp when the failure was recorded

## Other responses

- `404` — Webhook or seller not found

---

[API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/versions/5ed45d6a9e2f/schema)