# Get a broadcast

`GET /v1/broadcasts/{id}`

Fetches a broadcast by its ID, with its status and counts so far.

Needs `broadcasts:read`.

## Path parameters

- `id` (string, uuid): The broadcast's ID.

## Example

```sh
curl https://app.soosh.io/v1/broadcasts/2e4a6c8e-0b1d-4f3a-a5c7-9e1b3d5f7a2c \
  -H "Authorization: Bearer $SOOSH_API_KEY"
```

Response 200:

```json
{
  "id": "2e4a6c8e-0b1d-4f3a-a5c7-9e1b3d5f7a2c",
  "name": "Diwali offer",
  "status": "completed",
  "template": {
    "id": "8d2f4c1e-7a3b-4e59-b0c6-1f2e3d4c5b6a",
    "name": "diwali_offer",
    "language": "en"
  },
  "number_id": "0f6d3c1e-5b7a-4c52-9a55-3f6a2d5c8b10",
  "send_at": null,
  "started_at": "2026-10-14T09:31:40.912Z",
  "completed_at": "2026-10-14T09:33:08.774Z",
  "paused_reason": null,
  "counts": {
    "total": 250,
    "sent": 247,
    "delivered": 244,
    "read": 171,
    "failed": 3,
    "replied": 21,
    "clicked": 14
  },
  "skipped": {
    "opted_out": 6,
    "duplicate": 2,
    "invalid_phone": 1
  },
  "created_by": {
    "type": "api_key",
    "id": "5e1d2c3b-4a59-4f68-8e7d-6c5b4a392817",
    "name": "Order system"
  },
  "created_at": "2026-10-14T09:31:40.552Z"
}
```

## Returns

200. The broadcast.

## Errors

Besides the ones every request can get (https://docs.soosh.io/reference/api/errors/):

- 404 `not_found`: There is no broadcast with this ID in your workspace.