Retrieve a broadcast▾
GET

Retrieve a broadcast

Fetch one broadcast and its live counters.

Poll this while a broadcast runs, or subscribe to broadcast.completed and read it once.

GET/v1/broadcasts/{id}

Path parameters

idstringrequired

bc_….

curl -X GET https://api.sendport.tech/v1/broadcasts/{id} \
  -H "Authorization: Bearer $SENDPORT_KEY"

Responses

200OK
{
  "object": "broadcast",
  "id": "bc_01JZQ5D4P6R8T0V2X4Z6B8DFHK",
  "name": "September promo",
  "template": { "name": "seasonal_promo", "language": "en" },
  "status": "running",
  "audience": { "size": 12480, "filter": { "tags": ["vip"] } },
  "counts": { "queued": 3120, "sent": 9002, "delivered": 8741, "read": 5310, "failed": 358 },
  "estimated_cost": { "amount": "158.24", "currency": "USD" },
  "created_at": "2026-09-06T09:14:22.114Z"
}
401Unauthorized
{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No API key provided.",
    "doc_url": "https://sendport.tech/docs/errors#missing_api_key",
    "request_id": "req_9f3c2a7b41de08c5b2e6"
  }
}
Try itsandbox
PreviousCreate a broadcastNextList broadcast recipients