---
title: "List broadcasts"
description: "Every broadcast in this workspace, newest first, one page at a time, each with live `counts`. `audienceId` keeps the ones that were sent to that audience, alone or beside others."
url: "https://openemail.uk/docs/api/broadcasts/list"
area: "API"
category: "Mailbox"
---

# List broadcasts

Every broadcast in this workspace, newest first, one page at a time, each with live `counts`. `audienceId` keeps the ones that were sent to that audience, alone or beside others.

`GET /broadcasts`

## GET /broadcasts

Every broadcast in this workspace, newest first, one page at a time, each with live `counts`. `audienceId` keeps the ones that were sent to that audience, alone or beside others.

## Example

Needs `emails:read`. `limit` goes up to 100 and defaults to 25, and `cursor` takes the previous page's `nextCursor`, the id of its last broadcast.

**curl**

```
curl "$OE/broadcasts?audienceId=aud_4c1b8e2a7d9f05c36b4e8a71&limit=10" -H "$AUTH"
```

**Response**

```
{
  "object": "list",
  "data": [
    {
      "object": "broadcast",
      "id": "brd_5a8c1e3f7b2d94a06c8e1f3b",
      "status": "sending",
      "mode": "live",
      "source": "api",
      "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"],
      "from": "Acme <news@acme.com>",
      "subject": "{{firstName|Hello}}, the September release is out",
      "counts": {
        "recipients": 412,
        "created": 250,
        "skipped": 1,
        "failedToQueue": 0,
        "queued": 38,
        "sending": 2,
        "sent": 209,
        "failed": 1,
        "cancelled": 0
      },
      "lastError": null,
      "scheduledAt": null,
      "startedAt": "2026-09-23T12:00:02.000Z",
      "completedAt": null,
      "cancelledAt": null,
      "createdAt": "2026-09-23T12:00:00.000Z",
      "updatedAt": "2026-09-23T12:00:41.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}
```

> The individual messages are not here. List the copies of one broadcast with `GET /emails?broadcastId=`.

> A cursor that names no broadcast in this workspace is a `400` `invalid_cursor`. An `audienceId` that names no audience answers an empty page.