API referenceEndpointsBroadcastsId
Retrieve a broadcast
Returns one broadcast with its status and counts.
Authorization
apiKey AuthorizationBearer <token>
An API key from the dashboard (ms_…), sent as Authorization: Bearer. A sending-only key reaches the /emails routes only.
In: header
Path Parameters
id*string
Format
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/broadcasts/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "ae2014de-c168-4c61-8267-70d2662a1ce1", "name": "Order updates", "segment_id": "ae2014de-c168-4c61-8267-70d2662a1ce1", "status": "status", "created_at": "2026-10-19T12:00:00.000Z", "scheduled_at": "2026-10-19T12:00:00.000Z", "sent_at": "2026-10-19T12:00:00.000Z", "sent_count": 1, "finishes_at": "2026-10-19T12:00:00.000Z", "object": "broadcast", "from": "Acme <hello@yourdomain.com>", "subject": "Your order has shipped", "reply_to": [ "support@yourdomain.com" ], "preview_text": "Your order is on its way", "topic_id": "ae2014de-c168-4c61-8267-70d2662a1ce1", "html": "<p>Your order is on its way.</p>", "text": "Your order is on its way."}