Broadcasts

Get broadcast

Retrieve one broadcast with its body and send progress (total_recipients, sent_count, failed_count).

GEThttps://api.sndr.sh/v1/broadcasts/{id}

Get broadcast

curl 'https://api.sndr.sh/v1/broadcasts/bca_9b3e6d12-a40' \
  -H "Authorization: Bearer $SNDR_API_KEY"

200OK

{
  "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":           "sending",
  "total_recipients": 4200,
  "sent_count":       1630,
  "failed_count":     4,
  "created_at":       "2026-05-28T14:00:00Z",
  "started_at":       "2026-06-01T09:00:00Z"
}

Authorization

Authorizationstringheaderrequired

Bearer followed by your API key. Needs the read scope.

Path parameters

idstringrequired

Broadcast ID (bca_...).

Errors

401unauthenticatedMissing or invalid API key.

403insufficient_scopeThe API key is missing the read scope.

404not_foundResource does not exist or belongs to a different account.