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

# List broadcasts

`GET /v1/broadcasts`

Returns broadcasts with delivery stats. Filter by status, platform, or profile.

## Query parameters

- `profileId` string
- `status` 'draft' | 'scheduled' | 'sending' | 'completed' | 'failed' | 'cancelled'
- `platform` string
- `limit` integer
- `skip` integer

## Response `200`

Broadcasts list

- object
  - `success` boolean
  - `broadcasts` object[]
    - `id` string
    - `name` string
    - `description` string
    - `platform` string
    - `accountId` string
    - `accountName` string — Display name of the sending account
    - `status` 'draft' | 'scheduled' | 'sending' | 'completed' | 'failed' | 'cancelled'
    - `messagePreview` string — Template name or message text snippet
    - `scheduledAt` string, date-time
    - `startedAt` string, date-time
    - `completedAt` string, date-time
    - `recipientCount` integer
    - `sentCount` integer
    - `deliveredCount` integer
    - `readCount` integer
    - `failedCount` integer
    - `createdAt` string, date-time
  - `pagination` object
    - `total` integer
    - `limit` integer
    - `skip` integer
    - `hasMore` boolean

## Other responses

- `400` — Invalid request
- `401` — Unauthorized

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/f81ca70ea6b9/schema)