---
title: "List broadcast recipients"
method: GET
path: "/v1/broadcasts/{broadcastId}/recipients"
tags: ["Broadcasts"]
---

# List broadcast recipients

`GET /v1/broadcasts/{broadcastId}/recipients`

Returns recipients for a broadcast with individual delivery status. Filter by status.

## Path parameters

- `broadcastId` string, required

## Query parameters

- `status` 'pending' | 'sent' | 'delivered' | 'read' | 'failed'
- `limit` integer
- `skip` integer

## Response `200`

Recipients list with delivery status

- object
  - `success` boolean
  - `recipients` object[]
    - `id` string
    - `contactId` string
    - `channelId` string
    - `platformIdentifier` string
    - `contactName` string
    - `status` 'pending' | 'sent' | 'delivered' | 'read' | 'failed'
    - `messageId` string
    - `error` string
    - `errorCode` integer, nullable — Meta WhatsApp error code (e.g. 131049 for antispam, 131021 for invalid phone, 131026 for re-engagement required). Only populated for status=failed.
    - `errorExplanation` string, nullable — Plain-language translation of errorCode (e.g. for 131026, that the recipient has likely opted out of marketing messages). Null for unmapped codes; fall back to error.
    - `sentAt` string, date-time
    - `deliveredAt` string, date-time
    - `readAt` string, date-time
  - `pagination` object
    - `total` integer
    - `limit` integer
    - `skip` integer
    - `hasMore` boolean

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Resource not found

---

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