---
title: "Get broadcasts"
method: GET
path: "/companies/{company_key}/mobiledb/broadcasts"
tags: ["Broadcast API"]
---

# Get broadcasts

`GET /companies/{company_key}/mobiledb/broadcasts`

## Path parameters

- `company_key` string, required

## Query parameters

- `status` 'scheduled' | 'sent' | 'canceled' | 'in_progress' | 'failed' | 'paused' | 'deleted'

## Headers

- `X-API-Version` string

## Response `200`

Successful response

- BroadcastResponse[]
  - `broadcast_id` string — Vibes unique identifier for the broadcast.
  - `status` 'scheduled' | 'in_progress' | 'sent' | 'canceled' | 'deleted' | 'paused' | 'failed' — The status of the broadcast.
  - `name` string — The name of the campaign.
  - `send_scheduled_date` string — The date the campaign is scheduled to send.
  - `created_by` string — The user that created the campaign.
  - `created_by_application` string — The application that created the campaign, if applicable.
  - `targeting` object
    - `message_template` string — Body of the broadcast message.
    - `short_url_base` string — Base URL to use when shortening URLs.
    - `shorten_urls` boolean — Should URLs be shortened?
    - `channel` string — Message channel for broadcast.
    - `source_short_code` string — Short code the broadcast will be delviered on (if SMS or MMS).
    - `source_lists` string[]
    - `filters` object[] — Any filters used to target recipients.
    - `delivery` object
      - `send_start_date` string — Date the broadcast started.
      - `enqueue_completed_date` string — Date the final message was queued for delivery.
      - `recipient_count` integer — Number of recipients.
    - `url` string — Unique resource URL for the Broadcast Campaign.
    - `created_at` string — Date that the broadcast campaign was created in ISO-8601 format.
    - `updated_at` string — Date that the broadcast campaign was last updated in ISO-8601 format.

---

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