curl -X GET 'https://api.resend.com/broadcasts/id/recipients?type=sent&email=example-email&bounce_type=permanent&limit=10&after=example-after&before=example-before' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0'

# GET /broadcasts/{id}/recipients (Resend API)
Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-10-20

> Retrieve broadcast recipients

## 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/broadcasts/id/recipients?type=sent&email=example-email&bounce_type=permanent&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 Broadcast ID. |
| type | query | string | Yes | The recipient event type to filter by. |
| email | query | string | No | Filter recipients whose email address contains this value. |
| bounce_type | query | string | No | Filter bounced recipients by bounce type. Only valid when... |
Other params: limit, after, before

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

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

GET

GET /broadcasts/{id}/recipients — Resend API

Resend API

Retrieve broadcast recipients

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

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 214 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/broadcasts/id/recipients?type=sent&email=example-email&bounce_type=permanent&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 Broadcast ID.
type	query	string	Yes	The recipient event type to filter by.
email	query	string	No	Filter recipients whose email address contains this value.
bounce_type	query	string	No	Filter bounced recipients by bounce type. Only valid when `type` is `bounced`.
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": "b2Zmc2V0OjA",
      "contact_id": "e169aa45-1ecf-4183-9955-b1499d5701d3",
      "email": "[email protected]",
      "count": 3,
      "bounce_type": "permanent",
      "clicked_links": [
        {
          "url": "https://resend.com/pricing",
          "clicks": 2
        }
      ]
    }
  ]
}

Get a free Resend API key → sponsored

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