---
title: "Get Broadcast Status"
method: GET
path: "/queue/broadcast"
tags: ["queue"]
---

# Get Broadcast Status

`GET /queue/broadcast`

Retrieves the status of a broadcast message by its ID

## Query parameters

- `broadcast_id` string, required

## Headers

- `x-phone` string

## Response `200`

Successful operation

- object
  - `broadcast_id` string — Unique identifier for the broadcast message
  - `org_id` string — Organization identifier that owns the broadcast
  - `message_payload` object — Container for the broadcast message content and metadata
    - `body` string — The actual content of the broadcast message
    - `message_type` 'chat' — Type of message being broadcast
    - `performed_by` string — Entity that initiated the broadcast
  - `created_at` string, date-time — Timestamp when the broadcast was created
  - `total_chats` integer — Total number of chat instances targeted by this broadcast
  - `sent_chats` integer — Number of chats where the broadcast has been successfully sent
  - `failed_chats` integer — Number of chats where the broadcast failed to send
  - `pending_chats` integer — Number of chats where the broadcast is queued but not yet sent
  - `total_delivered_count` integer, nullable — Total count of broadcast messages delivered to recipients
  - `total_read_count` integer, nullable — Total count of broadcast messages that have been read by recipients
  - `performed_by` string — Identifier of the user or system that initiated the broadcast
  - `performed_at` string, date-time, nullable — Timestamp when the broadcast was executed
  - `scheduled_at` string, date-time — Timestamp when the broadcast is scheduled to be sent
  - `broadcast_status` string, nullable — Current status of the broadcast (pending, in-progress, completed, failed, etc.)
  - `total_member_count` integer — Total number of members eligible to receive this broadcast
  - `delivered_percentage` number, float — Percentage of messages successfully delivered to recipients
  - `read_percentage` number, float — Percentage of delivered messages that have been read by recipients
  - `logs` string[] — List of log entries related to the broadcast's execution

---

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