curl -X GET 'https://api.resend.com/segments/id/contacts?limit=10&after=example-after&before=example-before' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0'

# GET /segments/{id}/contacts (Resend API)
Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-09-25

> Retrieve a list of contacts in a segment

## Critical Gotchas
* All requests must include a `User-Agent` header (e.g. `User-Agent: my-app/1.0`) or the API returns HTTP 403.

## cURL
curl -X GET 'https://api.resend.com/segments/id/contacts?limit=10&after=example-after&before=example-before' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| id | path | string | Yes | The Segment ID. |
| limit | query | integer | No | Number of items to return. |
| after | query | string | No | Return items after this cursor. |
| before | query | string | No | Return items before this cursor. |

## Response (200 OK)
{"object":"list","has_more":false}

---
Need an API key? Get one at https://resend.com/signup

GET

GET /segments/{id}/contacts — Resend API

Resend API

Retrieve a list of contacts in a segment

Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-09-25 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 202 tokens · Vary: Accept

Critical gotchas

All requests must include a User-Agent header (e.g. User-Agent: my-app/1.0) or the API returns HTTP 403.

cURL

curl -X GET 'https://api.resend.com/segments/id/contacts?limit=10&after=example-after&before=example-before' \  -H "Authorization: Bearer $RESEND_API_KEY" \  -H 'User-Agent: my-app/1.0'

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	The Segment ID.
limit	query	integer	No	Number of items to return.
after	query	string	No	Return items after this cursor.
before	query	string	No	Return items before this cursor.

Response 200 OK

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "e169aa45-1ecf-4183-9955-b1499d5701d3",
      "email": "[email protected]",
      "first_name": "Steve",
      "last_name": "Wozniak",
      "created_at": "2023-10-06 23:47:56.678+00",
      "unsubscribed": false
    }
  ]
}

Get a free Resend API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.