---
title: "List messages of a broadcast"
method: GET
path: "/broadcasts/{broadcastId}/messages"
tags: ["Broadcasts"]
---

# List messages of a broadcast

`GET /broadcasts/{broadcastId}/messages`

Returns a paginated list of messages for a specific broadcast. Use the `status` query parameter to filter by message status.

## Path parameters

- `broadcastId` string, uuid, required

## Query parameters

- `cursor` string — Opaque cursor returned by a previous call, used to fetch the next page
- `status` string — Filter by broadcast message status. Possible values: - `pending` — Message queued, not yet sent to WhatsApp. - `sent` — Message sent to WhatsApp, awaiting delivery confirmation. - `delivered` — WhatsApp confirmed the message was delivered to the recipient. - `read` — WhatsApp confirmed the recipient read the message. - `failed` — The send attempt or WhatsApp delivery failed. - `skipped` — The recipient was skipped (e.g., marketing opt-out).

## Response `200`

A paginated list of broadcast messages

- object
  - `data` object[], required
    - `id` string, uuid, required
    - `contactPhoneNumber` string, nullable, required
    - `status` string, nullable, required — Status of the broadcast message. Possible values: - `pending` — Message queued, not yet sent to WhatsApp. - `sent` — Message sent to WhatsApp, awaiting delivery confirmation. - `delivered` — WhatsApp confirmed the message was delivered to the recipient. - `read` — WhatsApp confirmed the recipient read the message. - `failed` — The send attempt or WhatsApp delivery failed. - `skipped` — The recipient was skipped (e.g., marketing opt-out).
    - `batchNumber` integer, nullable, required
    - `messageId` string, uuid, nullable, required
    - `content` string, nullable, required
    - `type` string, nullable, required
    - `from` string, nullable, required
    - `to` string, nullable, required
    - `sendDate` string, date-time, nullable, required
    - `deliverDate` string, date-time, nullable, required
    - `readDate` string, date-time, nullable, required
    - `createDate` string, date-time, required
  - `cursors` object
    - `next` string — Opaque cursor to fetch the next page. Absent when there are no more results

## Other responses

- `404` — Broadcast not found

---

[API](https://skmtc.net/indigohive/apis/cogfy-messenger-public-api.md) · [All operations](https://skmtc.net/indigohive/apis/cogfy-messenger-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/indigohive/cogfy-messenger-public-api/versions/30bd33ee45c9/schema)