Skip to main content
Resend Docs

Search documentation

Type to search this documentation.

List Topics

GET

/

topics

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

const resend = new Resend('re_xxxxxxxxx');

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

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

resend.api_key = "re_xxxxxxxxx"

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

Resend.api_key = "re_xxxxxxxxx"

Resend::Topics.list()
Go
package main

import (
	"context"

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

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

	client.Topics.ListWithContext(context.TODO(), nil)
}
Rust
use resend_rs::{list_opts::ListOptions, Resend, Result};

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

  let _list = resend.topics.list(ListOptions::default()).await?;

  Ok(())
}
Java
import com.resend.Resend;
import com.resend.core.exception.ResendException;
import com.resend.services.topics.model.ListTopicsResponseSuccess;

public class Main {
  public static void main(String[] args) throws ResendException {
    Resend resend = new Resend("re_xxxxxxxxx");

    ListTopicsResponseSuccess response = resend.topics().list();
  }
}
.NET
using Resend;

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

var resp = await resend.TopicListAsync();
Console.WriteLine( "Nr Topics={0}", resp.Content.Data.Count );
cURL
curl -X GET 'https://api.resend.com/topics' \
     -H 'Authorization: Bearer re_xxxxxxxxx'
CLI
resend topics list
Response
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "b6d24b8e-af0b-4c3c-be0c-359bbd97381e",
      "name": "Weekly Newsletter",
      "description": "Weekly newsletter for our subscribers",
      "default_subscription": "opt_in",
      "visibility": "public",
      "created_at": "2026-04-08 00:11:13.110779+00"
    }
  ]
}
Node.js
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

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

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

resend.api_key = "re_xxxxxxxxx"

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

Resend.api_key = "re_xxxxxxxxx"

Resend::Topics.list()
Go
package main

import (
	"context"

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

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

	client.Topics.ListWithContext(context.TODO(), nil)
}
Rust
use resend_rs::{list_opts::ListOptions, Resend, Result};

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

  let _list = resend.topics.list(ListOptions::default()).await?;

  Ok(())
}
Java
import com.resend.Resend;
import com.resend.core.exception.ResendException;
import com.resend.services.topics.model.ListTopicsResponseSuccess;

public class Main {
  public static void main(String[] args) throws ResendException {
    Resend resend = new Resend("re_xxxxxxxxx");

    ListTopicsResponseSuccess response = resend.topics().list();
  }
}
.NET
using Resend;

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

var resp = await resend.TopicListAsync();
Console.WriteLine( "Nr Topics={0}", resp.Content.Data.Count );
cURL
curl -X GET 'https://api.resend.com/topics' \
     -H 'Authorization: Bearer re_xxxxxxxxx'
CLI
resend topics list
JSON
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "b6d24b8e-af0b-4c3c-be0c-359bbd97381e",
      "name": "Weekly Newsletter",
      "description": "Weekly newsletter for our subscribers",
      "default_subscription": "opt_in",
      "visibility": "public",
      "created_at": "2026-04-08 00:11:13.110779+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