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

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

> Retrieve a list of contacts

## Critical Gotchas
* All requests must include a `User-Agent` header (e.g. `User-Agent: my-app/1.0`) or the API returns HTTP 403.
* The `to` field is an array of strings, even when sending to a single recipient.

## cURL
curl -X GET 'https://api.resend.com/contacts?segment_id=segment-id&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 |
| :--- | :--- | :--- | :--- | :--- |
| segment_id | query | string | No | Filter contacts by 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","data":[{}]}

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

GET

/contacts

Resend API

Retrieve a list of contacts

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

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 221 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.

The to field is an array of strings, even when sending to a single recipient.

cURL

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

Get a free Resend API key → sponsored

Parameters

Name	In	Type	Required	Description
segment_id	query	string	No	Filter contacts by 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",
  "data": [
    {
      "id": "e169aa45-1ecf-4183-9955-b1499d5701d3",
      "email": "steve.wozniak@gmail.com",
      "first_name": "Steve",
      "last_name": "Wozniak",
      "created_at": "2023-10-06 23:47:56.678+00",
      "unsubscribed": false
    }
  ]
}