---
title: "GET /v1/workspaces/{workspaceId}/broadcasts/{broadcastId}/readiness"
method: GET
path: "/v1/workspaces/{workspaceId}/broadcasts/{broadcastId}/readiness"
---

# GET /v1/workspaces/{workspaceId}/broadcasts/{broadcastId}/readiness

`GET /v1/workspaces/{workspaceId}/broadcasts/{broadcastId}/readiness`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/broadcasts/{broadcastId}/readiness`
- Auth: HTTP bearer

## Response `200`

Canonical read-back or idempotent receipt. Provider acceptance is sent; delivered requires a delivery event and does not prove inbox placement.

- object
  - `data` BroadcastReadiness, required
    - `broadcast_id` string, uuid, required
    - `product_id` string, uuid, required
    - `ready` boolean, required
    - `blockers` object[], required
      - `code` string, required
      - `message` string, required
    - `audience` BroadcastAudiencePreview, required
      - `count` integer, required
      - `missing_consent_evidence_count` integer, required
      - `sample` object[], required
        - `id` string, uuid, required
        - `email` string, required
        - `display_name` string, nullable, required
        - `attributes` object, required
      - `excluded` object, required
        - `suppressed` integer, required
        - `not_subscribed` integer, required
        - `missing_recipient_hash` integer, required
        - `missing_consent_evidence` integer, required
      - `eligible_count` integer, required
      - `required_variables` string[], required
      - `missing_personalization_fields` object[], required
        - `variable` string, required
        - `missingCount` integer, required
        - `sampleEmails` string[], required
      - `audience` CampaignAudience, required: Select all subscribed contacts or at least one nonempty contact_ids, list_ids, or segment_ids list.
        - `all_subscribed` boolean
        - `contact_ids` string[]
        - `list_ids` string[]
        - `segment_ids` string[]
    - `campaign_version` integer, required
    - `design_version` integer, nullable, required
    - `languages` object, nullable, required: Audience languages still translating never hold the Broadcast. Their readers get it once their translation is ready, and are skipped (translation_failed, translation_awaiting_review or translation_still_preparing) if it is not ready within a day of sending.
      - `requested` object[], required
        - `locale` string, required
        - `count` integer, required
      - `pending_locales` string[], required
      - `waiting_locales` string[], required
    - `sending` object, required
      - `route_kind` string, nullable
      - `sending_stream_id` string, uuid, nullable
      - `banger_send_limit` union
        - integer
        - string
      - `daily_send_limit` union
        - integer
        - string
      - `used` union
        - integer
        - string
      - `daily_used` union
        - integer
        - string
    - `delivery_pace` object, nullable, required
      - `days` integer, required
      - `daily_limit` integer, required
      - `message` string, required
    - `approval_requirements` object, required
      - `disposition` 'automatic' | 'human_required', required
      - `recipient_count` integer, nullable, required
      - `reasons` string[], required
      - `checks` string[], required
    - `footer` object, required
      - `identity_present` boolean, required
      - `address_present` boolean, required
    - `checks_are_advisory` true, required
    - `next_action` string, required

## Other responses

- `400`: Invalid input or missing operating product.
- `403`: Existing OAuth scope or product boundary denied.
- `409`: Stale version or idempotency conflict.
- `422`: Consent, suppression, personalization, or readiness blocker.

---

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