apicheats.dev resend/llms.txt Raw .md
GET

/broadcasts/{id}/recipients

Resend API

Retrieve broadcast recipients

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
→ 228 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/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 a free Resend API key → sponsored

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": "steve.wozniak@gmail.com",
      "count": 3,
      "bounce_type": "permanent",
      "clicked_links": [
        {
          "url": "https://resend.com/pricing",
          "clicks": 2
        }
      ]
    }
  ]
}