Skip to main content
GET
/
contacts
/
:contact_id
/
segments
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.contacts.segments.list({
  id: 'e169aa45-1ecf-4183-9955-b1499d5701d3',
});
$resend = Resend::client('re_xxxxxxxxx');

$resend->contacts->segments->list(
  contactId: 'e169aa45-1ecf-4183-9955-b1499d5701d3'
);
import resend

resend.api_key = 're_xxxxxxxxx'

params = {
    "contact_id": 'e169aa45-1ecf-4183-9955-b1499d5701d3',
}

segments = resend.Contacts.Segments.list(params)
require 'resend'

Resend.api_key = 're_xxxxxxxxx'

segments = Resend::Contacts::Segments.list(
  contact_id: 'e169aa45-1ecf-4183-9955-b1499d5701d3'
)
package main

import (
	"context"

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

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

	listParams := &resend.ListContactSegmentsRequest{
		ContactId: "479e3145-dd38-476b-932c-529ceb705947",
	}

	client.Contacts.Segments.List(listParams)
}
use resend_rs::{Resend, Result, list_opts::ListOptions};

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

  let _contacts = resend
    .contacts
    .list_contact_segment(
      "e169aa45-1ecf-4183-9955-b1499d5701d3",
      ListOptions::default()
    )
    .await?;

  Ok(())
}
import com.resend.*;

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

    resend.contacts().segments().list("e169aa45-1ecf-4183-9955-b1499d5701d3");
  }
}
using Resend;

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

var resp = await resend.ContactListSegmentsAsync( new Guid( "e169aa45-1ecf-4183-9955-b1499d5701d3" ));
Console.WriteLine( "Nr Segments={0}", resp.Content.Data.Count );
curl -X GET 'https://api.resend.com/contacts/e169aa45-1ecf-4183-9955-b1499d5701d3/segments' \
     -H 'Authorization: Bearer re_xxxxxxxxx'
resend contacts segments e169aa45-1ecf-4183-9955-b1499d5701d3
{
  "object": "list",
  "data": [
    {
      "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
      "name": "Registered Users",
      "created_at": "2026-10-06 22:59:55.977+00"
    }
  ],
  "has_more": false
}

Path Parameters

Either id or email must be provided.
id
string
The Contact ID.
email
string
The Contact Email.
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.contacts.segments.list({
  id: 'e169aa45-1ecf-4183-9955-b1499d5701d3',
});
$resend = Resend::client('re_xxxxxxxxx');

$resend->contacts->segments->list(
  contactId: 'e169aa45-1ecf-4183-9955-b1499d5701d3'
);
import resend

resend.api_key = 're_xxxxxxxxx'

params = {
    "contact_id": 'e169aa45-1ecf-4183-9955-b1499d5701d3',
}

segments = resend.Contacts.Segments.list(params)
require 'resend'

Resend.api_key = 're_xxxxxxxxx'

segments = Resend::Contacts::Segments.list(
  contact_id: 'e169aa45-1ecf-4183-9955-b1499d5701d3'
)
package main

import (
	"context"

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

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

	listParams := &resend.ListContactSegmentsRequest{
		ContactId: "479e3145-dd38-476b-932c-529ceb705947",
	}

	client.Contacts.Segments.List(listParams)
}
use resend_rs::{Resend, Result, list_opts::ListOptions};

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

  let _contacts = resend
    .contacts
    .list_contact_segment(
      "e169aa45-1ecf-4183-9955-b1499d5701d3",
      ListOptions::default()
    )
    .await?;

  Ok(())
}
import com.resend.*;

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

    resend.contacts().segments().list("e169aa45-1ecf-4183-9955-b1499d5701d3");
  }
}
using Resend;

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

var resp = await resend.ContactListSegmentsAsync( new Guid( "e169aa45-1ecf-4183-9955-b1499d5701d3" ));
Console.WriteLine( "Nr Segments={0}", resp.Content.Data.Count );
curl -X GET 'https://api.resend.com/contacts/e169aa45-1ecf-4183-9955-b1499d5701d3/segments' \
     -H 'Authorization: Bearer re_xxxxxxxxx'
resend contacts segments e169aa45-1ecf-4183-9955-b1499d5701d3
{
  "object": "list",
  "data": [
    {
      "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
      "name": "Registered Users",
      "created_at": "2026-10-06 22:59:55.977+00"
    }
  ],
  "has_more": false
}