---
title: "Retrieve all broadcasts."
method: GET
path: "/api/v1/email/campaigns/broadcasts"
tags: ["Email"]
---

# Retrieve all broadcasts.

`GET /api/v1/email/campaigns/broadcasts`

## Request

- Base URL: `https://go.outseta.com`
- URL: `https://go.outseta.com/api/v1/email/campaigns/broadcasts`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

Archived broadcasts are excluded.

## Query parameters

- `tagUid` string
- `withoutTagUid` string
- `limit` integer
- `offset` integer

## Response `200`

- object
  - `metadata` CollectionMetadata
    - `limit` integer
    - `offset` integer
    - `total` integer
  - `items` BroadcastCampaign[]
    - `Uid` string, nullable
    - `_objectType` string, nullable
    - `Created` string, date-time, required
    - `Updated` string, date-time, required
    - `ActivityEventData` unknown
    - `SendDateTime` string, date-time, nullable
    - `NextRunDateTime` string, date-time, nullable
    - `Campaign` Campaign
      - `Uid` string, nullable
      - `_objectType` string, nullable
      - `Created` string, date-time, required
      - `Updated` string, date-time, required
      - `ActivityEventData` unknown
      - `Name` string, required
      - `FromName` string, nullable
      - `FromEmail` string, nullable
      - `CampaignType` 1 | 2: `1` - Broadcast, `2` - Drip
    - `Message` Message
      - `Uid` string, nullable
      - `_objectType` string, nullable
      - `Created` string, date-time, required
      - `Updated` string, date-time, required
      - `ActivityEventData` unknown
      - `Template` Template
        - `Uid` string, nullable
        - `_objectType` string, nullable
        - `Created` string, date-time, required
        - `Updated` string, date-time, required
        - `ActivityEventData` unknown
        - `Name` string, required
        - `Subject` string, nullable
        - `Body` string, required
        - `Design` string, nullable
        - `Description` string, nullable
        - `SystemName` string, nullable
        - `IsInternal` boolean
        - `AvailableTokens` string, nullable
        - `RequiredTokens` string, nullable
        - `Tag` string, nullable
      - `Name` string, required
      - `Subject` string, nullable
      - `PreviewText` string, nullable
      - `Body` string, nullable
      - `Design` string, nullable
      - `CountSent` integer
      - `CountDelivered` integer
      - `CountBounce` integer
      - `CountSpam` integer
      - `CountOpen` integer
      - `CountClick` integer
      - `CountUnsubscribed` integer
      - `CountTotalOpen` integer
      - `CountTotalClick` integer
      - `IgnoredSpamBounce` integer
      - `IsBounceRatePaused` boolean
      - `IsSpamScorePaused` boolean
      - `EmailLinks` EmailLink[], nullable
        - `Uid` string, nullable
        - `_objectType` string, nullable
        - `Created` string, date-time, required
        - `Updated` string, date-time, required
        - `ActivityEventData` unknown
        - `Name` string, nullable
        - `URL` string, nullable
        - `CountClick` integer
        - `CountTotalClick` integer
        - `RecipientIds` integer[], nullable
      - `SpamAssassinScore` number
      - `SpamStatus` 0 | 1 | 2 | 3 | 4 | 5 | 6: `0` - Draft, `1` - Pending, `2` - Processing, `3` - Reprocessing, `4` - Spam, `5` - NotSpam, `6` - Ignored
      - `SpamReason` string, nullable
    - `RecipientData` string, nullable
    - `EmailListUids` string[], nullable
    - `SegmentUids` string[], nullable
    - `TemplateUid` string, nullable
    - `Status` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10: `1` - Draft, `2` - Pending, `3` - Sent, `4` - Queuing, `5` - Queued, `6` - Sending, `7` - Error, `8` - WaitingToResume, `9` - QueuedEmails, `10` - Archived
    - `ErrorMessage` string, nullable
    - `Tags` Tag[], nullable
      - `Uid` string, nullable
      - `_objectType` string, nullable
      - `Created` string, date-time, required
      - `Updated` string, date-time, required
      - `ActivityEventData` unknown
      - `Name` string, required
      - `SystemName` string, nullable
      - `SystemDescription` string, nullable
      - `TagColor` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10: `1` - Red, `2` - Orange, `3` - Amber, `4` - Green, `5` - Teal, `6` - Blue, `7` - Indigo, `8` - Purple, `9` - Pink, `10` - Gray
      - `EntityType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13: `0` - None, `1` - Account, `2` - Person, `3` - Deal, `4` - Case, `5` - Invoice, `6` - EmailLog, `7` - Plan, `8` - DiscountCoupon, `9` - AddOn, `10` - Task, `11` - Segment, `12` - Broadcast, `13` - Article

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/outseta/apis/outseta-api.md) · [All operations](https://skmtc.dev/outseta/apis/outseta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outseta/apis/outseta-api/revisions/c362823af82d?raw)