---
title: "List broadcast recipients"
method: GET
path: "/v1/broadcasts/{id}/recipients"
tags: ["Broadcasts"]
---

# List broadcast recipients

`GET /v1/broadcasts/{id}/recipients`

## Request

- Base URL: `https://smtpfa.st/api`
- URL: `https://smtpfa.st/api/v1/broadcasts/{id}/recipients`
- Auth: HTTP bearer

Resend-compatible: recipients of a broadcast for one event type (sent, delivered, opened, clicked, bounced, complained, unsubscribed, suppressed), newest first, with after/before cursors. Each has contact_id; opened and clicked add count, clicked adds clicked_links, bounced adds bounce_type. Without type, every recipient (not in Resend). Requires the email:read scope.

## Path parameters

- `id` string, required

## Query parameters

- `type` 'sent' | 'delivered' | 'opened' | 'clicked' | 'bounced' | 'complained' | 'unsubscribed' | 'suppressed'
- `bounce_type` 'permanent' | 'transient' | 'undetermined'
- `email` string
- `limit` integer
- `after` string
- `before` string

## Response `200`

Recipients

- object

## Other responses

- `400`: Bad request - check your payload
- `401`: Invalid or missing API key
- `403`: Forbidden - domain not verified or insufficient permissions
- `404`: Resource not found
- `429`: Rate limit exceeded - retry after the period indicated in the Retry-After header
- `500`: Internal server error

---

[API](https://skmtc.dev/smtpfa/apis/smtpfast-api.md) · [All operations](https://skmtc.dev/smtpfa/apis/smtpfast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smtpfa/apis/smtpfast-api/revisions/79dda742f53e?raw)