Skip to main content
GET
/
broadcasts
/
:broadcast_id
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.broadcasts.get(
  '559ac32e-9ef5-46fb-82a1-b76b840c0f7b',
);

{
  "object": "broadcast",
  "id": "559ac32e-9ef5-46fb-82a1-b76b840c0f7b",
  "name": "Announcements",
  "audience_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf", // now called segment_id
  "segment_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "from": "Acme <onboarding@resend.dev>",
  "subject": "hello world",
  "reply_to": null,
  "preview_text": "Check out our latest announcements",
  "html": "<p>Hello {{{contact.first_name|there}}}!</p>",
  "text": "Hello {{{contact.first_name|there}}}!",
  "status": "draft",
  "created_at": "2026-12-01T19:32:22.980Z",
  "scheduled_at": null,
  "sent_at": null,
  "topic_id": "b6d24b8e-af0b-4c3c-be0c-359bbd97381e"
}

Documentation Index

Fetch the complete documentation index at: https://resend.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

You can retrieve broadcasts created via both this API and the Resend dashboard.

​
Path Parameters

See all available status types in the Broadcasts overview.
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.broadcasts.get(
  '559ac32e-9ef5-46fb-82a1-b76b840c0f7b',
);

{
  "object": "broadcast",
  "id": "559ac32e-9ef5-46fb-82a1-b76b840c0f7b",
  "name": "Announcements",
  "audience_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf", // now called segment_id
  "segment_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "from": "Acme <onboarding@resend.dev>",
  "subject": "hello world",
  "reply_to": null,
  "preview_text": "Check out our latest announcements",
  "html": "<p>Hello {{{contact.first_name|there}}}!</p>",
  "text": "Hello {{{contact.first_name|there}}}!",
  "status": "draft",
  "created_at": "2026-12-01T19:32:22.980Z",
  "scheduled_at": null,
  "sent_at": null,
  "topic_id": "b6d24b8e-af0b-4c3c-be0c-359bbd97381e"
}