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",
  "from": "Acme <onboarding@resend.dev>",
  "subject": "hello world",
  "reply_to": null,
  "preview_text": "Check out our latest announcements",
  "html": "<p>Hello {{{FIRST_NAME|there}}}!</p>",
  "text": "Hello {{{FIRST_NAME|there}}}!",
  "status": "draft",
  "created_at": "2024-12-01T19:32:22.980Z",
  "scheduled_at": null,
  "sent_at": null
}
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",
  "from": "Acme <onboarding@resend.dev>",
  "subject": "hello world",
  "reply_to": null,
  "preview_text": "Check out our latest announcements",
  "html": "<p>Hello {{{FIRST_NAME|there}}}!</p>",
  "text": "Hello {{{FIRST_NAME|there}}}!",
  "status": "draft",
  "created_at": "2024-12-01T19:32:22.980Z",
  "scheduled_at": null,
  "sent_at": null
}
⌘I