Skip to main content
Resend Docs

Search documentation

Type to search this documentation.

List Broadcasts

GET

/

broadcasts

Node.js
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.broadcasts.list();
PHP
$resend = Resend::client('re_xxxxxxxxx');

$resend->broadcasts->list();
Python
import resend

resend.api_key = "re_xxxxxxxxx"

resend.Broadcasts.list()
Ruby
require "resend"

Resend.api_key = "re_xxxxxxxxx"

Resend::Broadcasts.list()
Go
package main

import "github.com/resend/resend-go/v4"

func main() {
	client := resend.NewClient("re_xxxxxxxxx")

	client.Broadcasts.List()
}
Rust
use resend_rs::{Resend, Result, list_opts::ListOptions};

#[tokio::main]
async fn main() -> Result<()> {
  let resend = Resend::new("re_xxxxxxxxx");

  let _broadcasts = resend.broadcasts.list(ListOptions::default()).await?;

  Ok(())
}
Java
import com.resend.Resend;
import com.resend.services.broadcasts.model.ListBroadcastsResponseSuccess;

Resend resend = new Resend("re_xxxxxxxxx");

ListBroadcastsResponseSuccess data = resend.broadcasts().list();
.NET
using Resend;

IResend resend = ResendClient.Create( "re_xxxxxxxxx" ); // Or from DI

var resp = await resend.BroadcastListAsync();
Console.WriteLine( "Nr Broadcasts={0}", resp.Content.Count );
cURL
curl -X GET 'https://api.resend.com/broadcasts' \
     -H 'Authorization: Bearer re_xxxxxxxxx'
CLI
resend broadcasts list
Response
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794",
      "name": "Announcements",
      "audience_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf", // now called segment_id
      "segment_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
      "status": "draft",
      "created_at": "2026-11-01 15:13:31.723+00",
      "scheduled_at": null,
      "sent_at": null
    },
    {
      "id": "559ac32e-9ef5-46fb-82a1-b76b840c0f7b",
      "name": "Black Friday",
      "audience_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf", // now called segment_id
      "segment_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
      "status": "sent",
      "created_at": "2026-12-01 19:32:22.980+00",
      "scheduled_at": "2026-12-02 19:32:22.980+00",
      "sent_at": "2026-12-02 19:32:22.980+00"
    }
  ]
}
Node.js
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.broadcasts.list();
PHP
$resend = Resend::client('re_xxxxxxxxx');

$resend->broadcasts->list();
Python
import resend

resend.api_key = "re_xxxxxxxxx"

resend.Broadcasts.list()
Ruby
require "resend"

Resend.api_key = "re_xxxxxxxxx"

Resend::Broadcasts.list()
Go
package main

import "github.com/resend/resend-go/v4"

func main() {
	client := resend.NewClient("re_xxxxxxxxx")

	client.Broadcasts.List()
}
Rust
use resend_rs::{Resend, Result, list_opts::ListOptions};

#[tokio::main]
async fn main() -> Result<()> {
  let resend = Resend::new("re_xxxxxxxxx");

  let _broadcasts = resend.broadcasts.list(ListOptions::default()).await?;

  Ok(())
}
Java
import com.resend.Resend;
import com.resend.services.broadcasts.model.ListBroadcastsResponseSuccess;

Resend resend = new Resend("re_xxxxxxxxx");

ListBroadcastsResponseSuccess data = resend.broadcasts().list();
.NET
using Resend;

IResend resend = ResendClient.Create( "re_xxxxxxxxx" ); // Or from DI

var resp = await resend.BroadcastListAsync();
Console.WriteLine( "Nr Broadcasts={0}", resp.Content.Count );
cURL
curl -X GET 'https://api.resend.com/broadcasts' \
     -H 'Authorization: Bearer re_xxxxxxxxx'
CLI
resend broadcasts list
JSON
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794",
      "name": "Announcements",
      "audience_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf", // now called segment_id
      "segment_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
      "status": "draft",
      "created_at": "2026-11-01 15:13:31.723+00",
      "scheduled_at": null,
      "sent_at": null
    },
    {
      "id": "559ac32e-9ef5-46fb-82a1-b76b840c0f7b",
      "name": "Black Friday",
      "audience_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf", // now called segment_id
      "segment_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
      "status": "sent",
      "created_at": "2026-12-01 19:32:22.980+00",
      "scheduled_at": "2026-12-02 19:32:22.980+00",
      "sent_at": "2026-12-02 19:32:22.980+00"
    }
  ]
}

Was this page helpful?

⌘I

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu