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

# List broadcasts

`GET /v1/broadcasts`

Returns a list of your API-triggered broadcasts and associated metadata.

## Response `200`

Returns an array of API-triggered broadcasts.

- object
  - `broadcasts` BroadcastObject[]
    - `id` integer — The identifier for a broadcast.
    - `deduplicate_id` string — An identifier in the format `id:timestamp` where the id is for the object you're working with (Automations, Deliveries, Exports, Identities, Newsletters, Segments, and Templates), and the timestamp is the last time the object was updated.
    - `name` string — The name of the broadcast.
    - `type` 'triggered_broadcast' — The type of broadcast.
    - `created` integer — The date time when the referenced ID was created.
    - `updated` integer — The date time when the referenced ID was last updated.
    - `active` boolean — If true, the broadcast is active.
    - `state` 'running' | 'draft' — The state of the broadcast.
    - `actions` object[] — A list of actions used by the broadcast.
      - `id` integer — The identifier for the action.
      - `type` 'email' | 'webhook' | 'push' | 'sms' | 'slack' — The type of action.
    - `msg_template_ids` object[] — Indicates the message template(s) used in this broadcast.
      - `id` integer — The identifier for the template.
      - `type` 'email' | 'webhook' | 'push' | 'sms' | 'slack' — The type of template.
    - `first_started` integer — The date and time when you activated the broadcast.
    - `tags` string[] — An array of tags you set on this broadcast.

## Other responses

- `429` — Your request is over the 10-per-second limit.

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/4b391af7cb06/schema)