Broadcasts

List broadcast recipients

List per-recipient delivery rows in queue order. Offset-paginated; status is pending, sending, sent or failed, and email_id links to GET /emails/{id}. An unknown broadcast returns an empty list.

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

curl 'https://api.sndr.sh/v1/broadcasts/bca_9b3e6d12-a40/recipients?limit=50&offset=0' \
  -H "Authorization: Bearer $SNDR_API_KEY"

200OK

{
  "data": [
    {
      "id":           "br_7f2c9a41e8d0",
      "broadcast_id": "bca_9b3e6d12-a40",
      "contact_id":   "con_0e6b7f21-c58",
      "email":        "jane@example.com",
      "variables":    {},
      "email_id":     "em_d2a8f6c1-3b9",
      "status":       "sent",
      "sent_at":      "2026-06-01T09:01:12Z",
      "created_at":   "2026-06-01T09:00:00Z"
    }
  ],
  "total": 4200
}

Authorization

Authorizationstringheaderrequired

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

Path parameters

idstringrequired

Broadcast ID (bca_...).

Query parameters

limitinteger

Page size. Default 50, max 500 (larger values fall back to 50).

offsetinteger

Number of rows to skip. Default 0.

Errors

401unauthenticatedMissing or invalid API key.

403insufficient_scopeThe API key is missing the read scope.