Retrieve a single topic

GET/topics/{id}Retrieve a single topic

Parameters

idstringpathrequired

The Topic ID.

Responses

objectGetTopicResponseSuccess

created_atstring · date-time

Timestamp indicating when the topic was created.

default_subscriptionstring

The default subscription status for the topic.

one of "opt_in", "opt_out"

descriptionstring

A description of the topic.

idstring

The ID of the topic.

namestring

The name of the topic.

objectstring

The object type.

visibilitystring

The visibility of the topic.

one of "public", "private"

Example response

{
  "created_at": "2026-06-09T00:00:00Z",
  "default_subscription": "opt_in",
  "description": "string",
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "name": "Newsletter",
  "object": "topic",
  "visibility": "private"
}

Examples

idrequiredpath parameter

curl -X GET 'https://api.resend.com/topics/string'

const response = await fetch('https://api.resend.com/topics/string', { method: 'GET' });
const data = await response.json();

const response = await fetch('https://api.resend.com/topics/string', { method: 'GET' });
console.log(await response.json());

import requests

response = requests.request("GET", "https://api.resend.com/topics/string")
print(response.json())

package main

import (
	"context"
	"net/http"
)

func main() {
	ctx := context.Background()
	req, err := http.NewRequestWithContext(ctx, "GET", "https://api.resend.com/topics/string", nil)
	if err != nil {
		panic(err)
	}
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

<?php
$request = curl_init("https://api.resend.com/topics/string");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($request);
curl_close($request);

var request = HttpRequest.newBuilder(URI.create("https://api.resend.com/topics/string"))
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI("https://api.resend.com/topics/string")
request = Net::HTTPGenericRequest.new("GET", false, true, uri)
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.resend.com/topics/string");
using var response = await client.SendAsync(request);

{
  "created_at": "2026-06-09T00:00:00Z",
  "default_subscription": "opt_in",
  "description": "string",
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "name": "Newsletter",
  "object": "topic",
  "visibility": "private"
}

Search documentation

Emails

Domains

Audiences

Contacts

Receiving Emails

Webhooks

Templates

Broadcasts

Segments

Topics

Contact Properties

Logs

Automations

Events

API keys