---
title: "Get broadcast recipients"
method: GET
path: "/sms/broadcasts/{broadcastId}/recipients"
tags: ["Recipients", "Broadcasts"]
---

# Get broadcast recipients

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

## Request

- Base URL: `https://yourAccountName.api-us1.com/api/3`
- URL: `https://yourAccountName.api-us1.com/api/3/sms/broadcasts/{broadcastId}/recipients`
- Auth: API key in header `Api-Token`

Fetch all contacts who were sent a specific broadcast

## Path parameters

- `broadcastId` integer, required

## Query parameters

- `start_date` string, date
- `end_date` string, date
- `filters[deliverability][]` string[]
- `filters[engagement][]` string[]
- `search` string
- `order[field]` 'name' | 'phone' | 'sentDate' | 'clicks' | 'deliverability' | 'optOut' | 'replies'
- `offset` integer
- `limit` integer

## Response `200`

Recipients retrieved successfully

- RecipientsResponse
  - `recipients` Recipient[]
    - `id` integer: Contact ID
    - `name` string
    - `phoneNumber` string
    - `sentDate` string, date-time: Timestamp in CST
    - `clicks` integer
    - `deliverability` 'delivered' | 'failed'
    - `replies` object[]
      - `message` string
      - `date` string, date-time: Timestamp in CST
    - `optOut` 'yes' | 'no'
    - `details` object
      - `errorCode` string
      - `errorSource` 'ac' | 'twilio'
  - `meta` object
    - `total` integer
    - `limit` integer
    - `offset` integer

---

[API](https://skmtc.dev/activecampaign/apis/sms-broadcast-api.md) - [All operations](https://skmtc.dev/activecampaign/apis/sms-broadcast-api/llms.txt) - [OpenAPI document](https://skmtc.dev/activecampaign/apis/sms-broadcast-api/revisions/49f06f290f60?raw)