---
title: "Get broadcast send progress"
method: GET
path: "/v1/broadcasts/{broadcast_id}/progress"
tags: ["Broadcasts"]
---

# Get broadcast send progress

`GET /v1/broadcasts/{broadcast_id}/progress`

## Request

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

Returns bounded delivery progress, current rates, timing, outcome counts, and pause state. Poll until terminal is true; use 5 to 10 second intervals while progress changes and back off to 30 seconds when unchanged.

## Path parameters

- `broadcast_id` string, required

## Response `200`

Broadcast send progress

- object
  - `data` BroadcastSendProgress, required
    - `run_id` string, required
    - `phase` 'preparing' | 'sending' | 'paused' | 'canceling' | 'sent' | 'sent_with_errors' | 'canceled' | 'failed', required
    - `selected` integer, required
    - `materialized` integer, required
    - `sent` integer, required
    - `accepted` integer, required
    - `skipped` integer, required
    - `retrying` integer, required
    - `permanent_failed` integer, required
    - `unknown` integer, required
    - `canceled` integer, required
    - `percent_complete` number, required
    - `effective_rate` number, required
    - `provider_limited_rate` number, nullable, required
    - `provider` string, nullable, required: The email delivery provider used by this send.
    - `estimated_completion` string, date-time, nullable, required
    - `estimated_completion_basis` 'current-rate' | 'provider-quota', nullable, required: Whether the estimate uses only the current rate or also includes known provider quota windows.
    - `last_progress_at` string, date-time, nullable, required
    - `pause_reason` string, nullable, required
    - `next_retry_at` string, date-time, nullable, required
    - `next_retry_action` 'resume' | 'recheck', nullable, required: Whether the next time is a known quota reset or another connection check.
    - `pause_message` string, nullable, required
    - `terminal` boolean, 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)