---
title: "GET /v1/mailboxes/{mailboxId}/broadcasts/{broadcastId}"
method: GET
path: "/v1/mailboxes/{mailboxId}/broadcasts/{broadcastId}"
---

# GET /v1/mailboxes/{mailboxId}/broadcasts/{broadcastId}

`GET /v1/mailboxes/{mailboxId}/broadcasts/{broadcastId}`

## Request

- The document declares no server URL.
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `/authorize`, token URL `/oauth/token`, scopes: `email.read`)
  - HTTP bearer

One broadcast, with its delivery progress. Safe to poll while it drains.

## Path parameters

- `mailboxId` string, required
- `broadcastId` string, required

## Response `200`

The request has succeeded.

- BroadcastDetail
  - `id` string, required
  - `audienceId` string, required
  - `templateId` string, required
  - `from` string, required: The address every recipient is sent from, as the rail will send it.
  - `status` 'draft' | 'sending' | 'sent', required
  - `recipientCount` integer, required: Audience members discovered so far, including those it will not send to (see `BroadcastProgress.skipped`). 0 until dispatch enumerates the audience on the queue.
  - `createdAt` string, date-time, required
  - `sentAt` string, date-time, nullable, required
  - `progress` BroadcastProgress, required
    - `pending` integer, required
    - `sent` integer, required
    - `failed` integer, required
    - `skipped` integer, required: Members not sent to: unsubscribed or suppressed when the audience was walked, or by the time their turn came. A broadcast whose every member is skipped is `sent` to nobody — never an empty audience.

## Other responses

- `401`: Access is unauthorized.
- `403`: Access is forbidden.
- `404`: The server cannot find the requested resource.
- `default`: An unexpected error response.

---

[API](https://skmtc.dev/foundermail/apis/mailbox.md) - [All operations](https://skmtc.dev/foundermail/apis/mailbox/llms.txt) - [OpenAPI document](https://skmtc.dev/foundermail/apis/mailbox/revisions/6a50628a86ed?raw)