---
title: "Get all broadcast messages"
method: GET
path: "/sms/broadcasts"
tags: ["Broadcasts"]
---

# Get all broadcast messages

`GET /sms/broadcasts`

## Request

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

Gets a paged list of all of a customer's broadcast messages with optional filtering

## Query parameters

- `offset` integer
- `limit` integer
- `filters[name]` string
- `filters[status]` 'draft' | 'scheduled' | 'sent' | 'pending_review' | 'sending'
- `filters[type]` string
- `orders[field]` 'ASC' | 'DESC'
- `start_date` string, date
- `end_date` string, date

## Response `200`

Successful response

- BroadcastListResponse
  - `broadcasts` BroadcastMessage[]
    - `id` integer: Unique identifier for the broadcast
    - `name` string: Name of the broadcast
    - `address_id` integer, nullable: ID used to get sender name
    - `body` string: SMS message content
    - `media_urls` string[]: Media URLs for MMS messages
    - `preview_url` string, uri: URL for message preview
    - `shorten_track_links_enabled` boolean: Whether link shortening is enabled
    - `status` 'draft' | 'scheduled' | 'sent' | 'pending_review' | 'sending': Current status of the broadcast
    - `sent_date` string, date-time, nullable: Date when broadcast was sent
    - `scheduled_date` string, date-time, nullable: Scheduled send date (UTC)
    - `custom_run_id` string, uuid, nullable: custom run id generated from segmentMatchSome endpoint
    - `custom_segment_id` string, uuid, nullable: custom segment id generated from segmentsV2 endpoint and passing in a valid audience
    - `scheduled_by` integer, nullable: User ID who scheduled the broadcast
    - `sent_to_count` integer, nullable: Number of recipients
    - `created_at` string, date-time: Creation timestamp
    - `created_by` integer: User ID who created the broadcast
    - `updated_at` string, date-time: Last update timestamp
    - `updated_by` integer: User ID who last updated
    - `deleted_at` string, date-time, nullable: Deletion timestamp (for soft deletes)
    - `sift_approved` integer: Sift approval status
    - `arc_approved` integer: ARC approval status
    - `quiet_hours_enabled` integer, nullable: Whether quiet hours are enabled
    - `list_ids` integer[]: Associated list IDs
    - `segment_id` string, nullable: Segment ID (can be UUID or integer string)
    - `label_ids` integer[], nullable: Associated label IDs
  - `meta` object
    - `total` integer: Total number of broadcasts

## Other responses

- `403`: Insufficient permissions

---

[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)