---
title: "List dead letters"
method: POST
path: "/api/sites/multiscreen/webhooks/dead-letters/query"
tags: ["Partner webhooks dead letters API"]
---

# List dead letters

`POST /api/sites/multiscreen/webhooks/dead-letters/query`

## Request

- Base URL: `https://api.duda.co`
- URL: `https://api.duda.co/api/sites/multiscreen/webhooks/dead-letters/query`
- Auth: HTTP basic

Returns a page of dead-letter items, optionally filtered by event type, failure time range, and resource.

## Request body

- PartnerApiWebhookDeadLetterQueryRequest
  - `event_types` string[]: Filter by webhook event types. If omitted, all event types are considered.
  - `failed_from` string, date-time: Include dead letters created at or after this UTC timestamp (inclusive).
  - `failed_to` string, date-time: Include dead letters created at or before this UTC timestamp (inclusive).
  - `limit` integer: Maximum number of results to return.
  - `offset` integer: Zero-based offset for pagination.
  - `resources` WebhookResource[]: Filter by resources. If omitted, dead letters from all resources visible to the authenticated account are returned.
    - `resourceId` string
    - `type` 'SITE' | 'ACCOUNT' | 'PRODUCT'

## Response `200`

OK

- PageResponsePartnerApiWebhookDeadLetterResponse
  - `limit` integer: Page size applied for request
  - `offset` integer: Offset applied for request
  - `results` PartnerApiWebhookDeadLetterResponse[]: Content payload
    - `failed_at` string, date-time: UTC timestamp when this dead-letter entry was created.
    - `id` integer: Dead-letter identifier.
    - `payload` object: Request body payload that was sent to the webhook endpoint.
    - `reason` string: Failure reason of the last delivery attempt.
    - `webhook` PartnerApiWebhookDeadLetterWebhookInfo: Webhook details for the failed delivery.
      - `endpoint` string: Webhook endpoint that failed to receive the delivery.
      - `event_type` string: Event type that triggered the webhook.
      - `id` integer: Webhook identifier that failed.
      - `resource` WebhookResource
        - `resourceId` string
        - `type` 'SITE' | 'ACCOUNT' | 'PRODUCT'
  - `total_responses` integer: Total amount of elements matching requested filters

## Other responses

- `400`: Bad request. The request is malformed or failed validation.
- `401`: Unauthorized. The credentials are missing or invalid.
- `429`: Too many requests. The rate limit was exceeded.

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)