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

# List broadcasts

`GET /v4/broadcasts`

Returns a cursor-paginated list of broadcasts in the account with their content, targeting (`subscriber_filter`), email template, and web-publishing settings. Filter by lifecycle `status` (`draft`, `scheduled`, `sending`, `completed`, `aborted`) and by the `sent_after`/`sent_before` timestamps. Default 500 results per page, maximum 1000.

**Tip:** set `slim=true` to omit the expensive fields (`content`, `public_url`, `email_address`, `email_template`, `subscriber_filter`) for a faster, smaller response — useful when you only need identifiers and subjects.

Delivery and engagement stats are not included in this response; use [Get stats for a list of broadcasts](/api-reference/broadcasts/get-stats-for-a-list-of-broadcasts) for those. Broadcasts that are also published as posts share a `publication_id` with the matching post from [List posts](/api-reference/posts/list-posts).

## Query parameters

- `after` unknown
- `before` unknown
- `include_total_count` boolean
- `per_page` unknown
- `sent_after` unknown
- `sent_before` unknown
- `slim` boolean
- `status` 'draft' | 'scheduled' | 'sending' | 'completed' | 'aborted'

## Response `200`

Returns a paginated list of all broadcasts for your account (including draft, scheduled, and already sent)

- object
  - `broadcasts` object[], required
    - `id` integer, required
    - `publication_id` integer, required — Identifier of the underlying publication. Broadcasts that are also published as posts share the same `publication_id` — use it to match a broadcast to its post via `GET /v4/posts`.
    - `created_at` string, required
    - `subject` string, required
    - `preview_text` string, nullable, required
    - `description` string, nullable, required
    - `content` string, nullable, required
    - `public` boolean, required
    - `published_at` string, nullable, required
    - `send_at` string, nullable, required
    - `thumbnail_alt` string, nullable, required
    - `thumbnail_url` string, nullable, required
    - `public_url` string, nullable, required
    - `email_address` string, nullable, required
    - `email_template` object, required
      - `id` integer, required
      - `name` string, required
    - `subscriber_filter` object[], required
      - `all` object[], required
        - `type` string, required
    - `status` string
  - `pagination` object, required
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `start_cursor` string, required
    - `end_cursor` string, required
    - `per_page` integer, required

## Other responses

- `401` — Returns a 401 if the token and/or account cannot be authenticated

---

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