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

# List messages of a broadcast

`GET /broadcasts/{broadcastId}/messages`

## Request

- Base URL: `https://messenger-public-api.cogfy.com`
- URL: `https://messenger-public-api.cogfy.com/broadcasts/{broadcastId}/messages`
- Auth: API key in header `api-key`
- TypeScript: <https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api/docs/broadcasts/:broadcastId/messages/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-08-07** `30bd33ee45c9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api/changes/broadcasts/:broadcastId/messages/get.md)

---

[API](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api.md) - [All operations](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api/revisions/30bd33ee45c9?raw)