Retrieve a list of segments for a contact

GET/contacts/{contact_id}/segmentsRetrieve a list of segments for a contact

Parameters

contact_idstringpathrequired

The Contact ID or email address.

limitintegerquery

Number of items to return.

maximum 100 · minimum 1

afterstringquery

Return items after this cursor.

beforestringquery

Return items before this cursor.

Responses

objectListContactSegmentsResponseSuccess

dataarray of object

Array containing segment information for this contact.

Show child attributes

Show array items

created_atstring · date-time

Timestamp indicating when the contact was added to the segment.

idstring

Unique identifier for the segment.

namestring

Name of the segment.

has_moreboolean

Indicates if there are more results available.

objectstring

Type of the response object.

Example response

{
  "data": [
    {
      "created_at": "2026-06-09T00:00:00Z",
      "id": "string",
      "name": "string"
    }
  ],
  "has_more": true,
  "object": "list"
}

Examples

contact_idrequiredpath parameter

limitquery parameter

afterquery parameter

beforequery parameter

curl -X GET 'https://api.resend.com/contacts/string/segments?after=string&before=string&limit=0'

const response = await fetch('https://api.resend.com/contacts/string/segments?after=string&before=string&limit=0', { method: 'GET' });
const data = await response.json();

const response = await fetch('https://api.resend.com/contacts/string/segments?after=string&before=string&limit=0', { method: 'GET' });
console.log(await response.json());

import requests

response = requests.request("GET", "https://api.resend.com/contacts/string/segments?after=string&before=string&limit=0")
print(response.json())

package main

import (
	"context"
	"net/http"
)

func main() {
	ctx := context.Background()
	req, err := http.NewRequestWithContext(ctx, "GET", "https://api.resend.com/contacts/string/segments?after=string&before=string&limit=0", 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/contacts/string/segments?after=string&before=string&limit=0");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($request);
curl_close($request);

var request = HttpRequest.newBuilder(URI.create("https://api.resend.com/contacts/string/segments?after=string&before=string&limit=0"))
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI("https://api.resend.com/contacts/string/segments?after=string&before=string&limit=0")
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/contacts/string/segments?after=string&before=string&limit=0");
using var response = await client.SendAsync(request);

{
  "data": [
    {
      "created_at": "2026-06-09T00:00:00Z",
      "id": "string",
      "name": "string"
    }
  ],
  "has_more": true,
  "object": "list"
}

Search documentation

Emails

Domains

Audiences

Contacts

Receiving Emails

Webhooks

Templates

Broadcasts

Segments

Topics

Contact Properties

Logs

Automations

Events

API keys