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

# List broadcasts

`GET /api/v1/broadcasts/`

## Request

- Base URL: `https://api.prolific.com`
- URL: `https://api.prolific.com/api/v1/broadcasts/`
- Auth: API key in header `Authorization`

Lists the broadcasts sent from your account, newest first, each with how many recipients have replied.

Pass `workspace_id` to list the broadcasts sent from that workspace instead. Pass `study_id` to only return broadcasts about that study.

Results are paginated. Follow `next` for the following page, or stop when it is null.

## Query parameters

- `workspace_id` string
- `study_id` string
- `limit` integer
- `cursor` string

## Response `200`

A page of broadcasts

- Broadcasts
  - `next` string, nullable, required: URL of the next page, or null on the last page.
  - `results` BroadcastWithReplies[], required
    - `id` string, required
    - `study_id` string, required
    - `subject` string, required
    - `topic` string, nullable, required
    - `body` string, required
    - `audience_source` 'submissions' | 'PARTICIPANT_GROUP' | 'TYPED_IDS' | 'MESSAGES', required
    - `participant_group` BroadcastWithRepliesParticipantGroup, required: The participant group it was sent to, or null.
      - `id` string, required
      - `name` string, required: The group's name when it was sent.
    - `recipient_count` integer, required
    - `datetime_created` string, date-time, required
    - `replied_count` integer, required: How many recipients have replied. Your own follow-ups don't count.

## Other responses

- `400`: Error
- `503`: Message service temporarily unavailable
- `504`: Message query timed out

## Changes

- **2026-10-27** `0eeae21e89fe`: 1 warning
  - added the new `MESSAGES` enum value to the `results/items/audience_source` response property for the response status `200`
- **2026-10-26** `498c9e20b1ce`: 1 warning
  - added the new `TYPED_IDS` enum value to the `results/items/audience_source` response property for the response status `200`
- **2026-10-23** `0a2c3f2c92ef`: 2 warning, 1 info
  - added the new `PARTICIPANT_GROUP` enum value to the `results/items/audience_source` response property for the response status `200`
  - added the new `submissions` enum value to the `results/items/audience_source` response property for the response status `200`
  - added the required property `results/items/participant_group` to the response with the `200` status
- **2026-10-22** `8ad56496a97c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/prolific/apis/api-reference/changes/api/v1/broadcasts/get.md)

---

[API](https://skmtc.dev/prolific/apis/api-reference.md) - [All operations](https://skmtc.dev/prolific/apis/api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/prolific/apis/api-reference/revisions/36e3bb40c638?raw)