Skip to main content
GET
List broadcast contacts

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

broadcastId
string
required

Query Parameters

status
enum<string>

Status of a contact within a broadcast.

  • pending, queued, sending: not handed to the provider yet.
  • sent: accepted by the provider; delivery is not confirmed yet. Channels that never report delivery leave the recipient here.
  • delivered: the channel confirmed delivery to the device. A WhatsApp read receipt also counts as delivered.
  • failed: not delivered. A recipient can move from sent or delivered to failed when the provider reports a failure late.
  • skipped: not sent, because the recipient opted out of the channel or the broadcast was cancelled before reaching it.
Available options:
pending,
queued,
sending,
sent,
delivered,
failed,
skipped
limit
integer
default:50
Required range: x <= 100
cursor
string

Response

List of broadcast contacts.

items
object[]
required
nextCursor
string | null