MepMail Docs
API referenceEndpointsBroadcastsId

Retrieve a broadcast

GET
/broadcasts/{id}

Returns one broadcast with its status and counts.

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
Formatuuid

Response 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."}