# The Broadcast object

> Attributes of a BloomText Broadcast and the endpoints that return it.

Source: https://www.bloomtext.com/developers/api/reference/broadcast-object/

Broadcast campaigns and their delivery status.

### Attributes

- `id` (UUID, required): Unique ID of the broadcast.

- `organization_id` (UUID, required): Organization that sent the broadcast.

- `status` (draft, queued, sent, partial, failed, required): Delivery status. `partial` means some recipients failed.

- `created_at` (timestamp, required): When the broadcast was created.

### Endpoints

| Method | Path | Endpoint |
| --- | --- | --- |
| GET | `/broadcasts` | [List broadcasts](https://www.bloomtext.com/developers/api/reference/list-broadcasts/) |
| GET | `/broadcasts/{broadcastId}` | [Retrieve a broadcast](https://www.bloomtext.com/developers/api/reference/get-broadcast/) |
| GET | `/broadcasts/{broadcastId}/messages` | [List broadcast messages](https://www.bloomtext.com/developers/api/reference/list-broadcast-messages/) |

```json filename="The Broadcast object"
{
  "id": "1f6a9c3e-2d4b-4e8a-9b7c-5d3e2f1a0b9c",
  "organization_id": "6db1e3f5-9b7f-4f2b-8be1-0f1e1d7d7d8c",
  "status": "sent",
  "created_at": "2026-09-21T15:04:05Z"
}
```