---
title: "List the broadcasts"
method: GET
path: "/v1/broadcasts"
tags: ["Broadcasts"]
---

# List the broadcasts

`GET /v1/broadcasts`

## Request

- Base URL: `https://api.sendora.se`
- URL: `https://api.sendora.se/v1/broadcasts`
- Auth: HTTP bearer

The broadcasts of this server, newest first, a page at a time.

## Query parameters

- `limit` integer
- `after` string, uuid

## Response `200`

A page of the broadcasts, newest first.

- object: A page of the broadcasts, newest first.
  - `broadcasts` object[], required
    - `broadcastId` string, uuid, required
    - `streamId` string, uuid, required: The broadcast stream the messages go on.
    - `status` 'accepted' | 'processing' | 'completed' | 'cancelled', required: accepted until the first message leaves, processing while messages are leaving, completed when every message has left or failed, cancelled once cancelled.
    - `from` string, required
    - `subject` string, required
    - `tag` string, nullable, required
    - `metadata` object, required
    - `total` integer, required: Messages stored, after suppressed addresses were dropped.
    - `released` integer, required: Messages handed to the mail server so far.
    - `failed` integer, required: Messages that could not be handed over, cancelled ones included.
    - `suppressed` integer, required: Addresses dropped from the list for standing on the stream’s suppression list.
    - `submittedAt` string, date-time, required
    - `completedAt` string, date-time, nullable, required: Set once nothing is left to send, or on cancel.
  - `next` string, uuid, nullable, required: Pass as `after` for the next page; null on the last.

## Other responses

- `400`: The body, the query or a header does not match what the route takes.
- `401`: The key is missing, malformed or revoked.
- `403`: The key is of the other kind, or a connected app may not do this here: it is not for connections, the connection may only read here, or it is for test servers only.

---

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