# List broadcasts

> List broadcasts on your workspace, newest first.

Source: https://sndr.sh/docs/api/broadcasts/list-broadcasts

`GET https://api.sndr.sh/v1/broadcasts`

List broadcasts on your workspace, newest first. Cursor-paginated. status is draft, queued, sending or sent.

Scope: `read`

**Query parameters**

- `limit` (integer): Page size. Default 50, max 200.
- `cursor` (string): The next_cursor value from the previous page. Omit for the first page.

**Request**

```bash
curl 'https://api.sndr.sh/v1/broadcasts' \
  -H "Authorization: Bearer $SNDR_API_KEY"
```

**Response** (200)

```json
{
  "data": [
    {
      "id":               "bca_9b3e6d12-a40",
      "organization_id":  "org_8d41c7a2-3f6",
      "name":             "June newsletter",
      "group_id":         "grp_4d8a0c5e-1f7",
      "from_email":       "hello@acme.com",
      "subject":          "June product update",
      "html":             "<h1>June update</h1><p>Here is what is new.</p>",
      "status":           "sent",
      "total_recipients": 4200,
      "sent_count":       4188,
      "failed_count":     12,
      "created_at":       "2026-05-28T14:00:00Z",
      "started_at":       "2026-06-01T09:00:00Z",
      "completed_at":     "2026-06-01T09:42:10Z"
    }
  ],
  "has_more": false,
  "count":    1,
  "limit":    50
}
```

**Errors**

- `unauthenticated` (401): Missing or invalid API key.
- `insufficient_scope` (403): The API key is missing the read scope.
- `validation_failed` (422): limit is above 200, or cursor is not a value returned as next_cursor.