broadcasts

List per-recipient broadcast results

GET /v1/broadcasts/{id}/results

Auth required api.broadcasts.view

Returns one page of per-recipient send outcomes for a broadcast, read from the authoritative ClickHouse send log, newest-first. Each row is one recipient decision: sent (handed to SES, message_id set), failed (SES rejected it, failure_reason set), or filtered (dropped by the consent filter before send, filter_tier + failure_reason set). The filtered rows explain the gap between the audience size and the sent count — who was dropped and why. Optionally narrow to one outcome with ?result=. Test-send rows are never included. 404 not_found when the id is not a broadcast in this org.

Path parameters

id string<uuid> required

Resource UUID. An unparseable id reads as a clean 404 not_found.

Query parameters

result string enum optional

Narrow to one outcome. Omit for all results.

limit integer optional

Page size (1–200). Default 50.

cursor string optional

Opaque cursor returned from the previous page.

Responses

200 Cursor-paginated list of per-recipient outcomes, newest-first application/json

401 Missing, malformed, or unknown API key application/problem+json

403 Key lacks the required scope or plan limit violated application/problem+json

404 Resource not found application/problem+json

422 Query parameter or path value failed validation application/problem+json

429 Per-org rate limit exceeded application/problem+json

500 Unexpected server-side failure. The code is internal_error. The request_id field can be quoted to SendOps support to investigate. application/problem+json

{ "data": [ { "contact_id": "string", "email": "string", "result": "sent", "failure_reason": "string", "filter_tier": "account", "message_id": "string", "occurred_at": "2026-05-17T20:00:00Z" } ], "pagination": { "has_more": true, "next_cursor": "string" } }