Broadcasts
List broadcasts
List broadcasts on your workspace, newest first. Cursor-paginated. status is draft, queued, sending or sent.
GET
https://api.sndr.sh/v1/broadcastsList broadcasts
curl 'https://api.sndr.sh/v1/broadcasts' \
-H "Authorization: Bearer $SNDR_API_KEY"200OK
{
"data": [
{
"id": "bca_9b3e6d12-a40",
"organization_id": "org_8d41c7a2-3f6",
"name": "June newsletter",
"group_id": "grp_4d8a0c5e-1f7",
"from_email": "hello@acme.com",
"subject": "June product update",
"html": "<h1>June update</h1><p>Here is what is new.</p>",
"status": "sent",
"total_recipients": 4200,
"sent_count": 4188,
"failed_count": 12,
"created_at": "2026-05-28T14:00:00Z",
"started_at": "2026-06-01T09:00:00Z",
"completed_at": "2026-06-01T09:42:10Z"
}
],
"has_more": false,
"count": 1,
"limit": 50
}Authorization
AuthorizationstringheaderrequiredBearer followed by your API key. Needs the read scope.
Query parameters
limitintegerPage size. Default 50, max 200.
cursorstringThe next_cursor value from the previous page. Omit for the first page.
Errors
401
unauthenticatedMissing or invalid API key.403
insufficient_scopeThe API key is missing the read scope.422
validation_failedlimit is above 200, or cursor is not a value returned as next_cursor.