---
title: "Run the pre-send checks for a broadcast"
method: GET
path: "/broadcasts/{id}/checks"
tags: ["Campaigns"]
---

# Run the pre-send checks for a broadcast

`GET /broadcasts/{id}/checks`

## Request

- Base URL: `https://sendhq.cc/api/v1`
- URL: `https://sendhq.cc/api/v1/broadcasts/{id}/checks`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sendhq/apis/sendhq-api/docs/broadcasts/:id/checks/get.ts> (a function with typed inputs; its response is checked against the schema)

The review list the dashboard shows before sending: sender verification, subject, preview text, content, audience size, email size against Gmail's 102 KB clipping limit, postal address, merge tags without data or fallback, empty or shortened links, missing image descriptions, leftover placeholder text, spam-prone wording, the free trial's own-address rule, and whether a test was sent. Each check has a `level` (`ok`, `warn`, or `block`); `ready` is false while any check blocks. Scheduling runs the same checks.

## Path parameters

- `id` string, required

## Response `200`

Successful response

- object
  - `ready` boolean, required
  - `checks` object[], required
    - `id` string, required
    - `level` string, required
    - `label` string, required
    - `detail` string, required
    - `tab` string, required
  - `audience` object, required
    - `total` integer, required
    - `matching` integer, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `402`: A paid entitlement is required for this recipient or feature
- `403`: The workspace, domain, policy, or suppression state forbids the operation
- `404`: Tenant-scoped resource not found
- `409`: Resource state or idempotency conflict
- `413`: Attachment count or bytes exceed the accepted limit
- `422`: Request validation or suppression check failed
- `423`: Sending is paused for this sender identity or workspace; the message gives the reason and how to appeal
- `429`: A monthly, daily, or trial usage limit was reached
- `500`: Unexpected server error
- `502`: An upstream provider operation failed
- `503`: A required provider or signing configuration is unavailable
- `default`: An error response using SendHQ's standard JSON envelope

---

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