Retrieve a single segment

GET/segments/{id}Retrieve a single segment

Parameters

idstringpathrequired

The Segment ID.

Responses

objectGetSegmentResponseSuccess

audience_idstring

The ID of the audience this segment belongs to.

created_atstring · date-time

Timestamp indicating when the segment was created.

filterobject

Filter conditions for the segment.

idstring

The ID of the segment.

namestring

The name of the segment.

objectstring

The object type.

Example response

{
  "audience_id": "string",
  "created_at": "2026-06-09T00:00:00Z",
  "filter": {},
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "name": "Active Users",
  "object": "segment"
}

Examples

idrequiredpath parameter

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

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

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

import requests

response = requests.request("GET", "https://api.resend.com/segments/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/segments/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/segments/string");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($request);
curl_close($request);

var request = HttpRequest.newBuilder(URI.create("https://api.resend.com/segments/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/segments/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/segments/string");
using var response = await client.SendAsync(request);

{
  "audience_id": "string",
  "created_at": "2026-06-09T00:00:00Z",
  "filter": {},
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "name": "Active Users",
  "object": "segment"
}

Search documentation

Emails

Domains

Audiences

Contacts

Receiving Emails

Webhooks

Templates

Broadcasts

Segments

Topics

Contact Properties

Logs

Automations

Events

API keys