---
title: "List broadcast delivery errors"
method: GET
path: "/v1/broadcasts/{broadcast_id}/delivery-errors"
tags: ["Broadcasts"]
---

# List broadcast delivery errors

`GET /v1/broadcasts/{broadcast_id}/delivery-errors`

## Request

- Base URL: `https://api.mailrith.com`
- URL: `https://api.mailrith.com/v1/broadcasts/{broadcast_id}/delivery-errors`
- Auth: HTTP bearer

Returns a cursor-paginated page of permanent failures and unknown delivery results.

## Path parameters

- `broadcast_id` string, required

## Query parameters

- `cursor` integer
- `limit` integer

## Response `200`

Delivery error page

- object
  - `data` object, required
    - `items` BroadcastDeliveryError[], required
      - `id` integer, required
      - `subscriber_id` string, required
      - `outcome` 'failed' | 'unknown', required
      - `attempt_count` integer, required
      - `error_code` string, nullable, required
      - `updated_at` string, date-time, required
    - `next_cursor` integer, nullable, required

## Other responses

- `404`: Resource not found

---

[API](https://skmtc.dev/mailrith/apis/mailrith-api.md) · [All operations](https://skmtc.dev/mailrith/apis/mailrith-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailrith/apis/mailrith-api/revisions/41f09536f2da?raw)