---
title: "List recipients for an email message"
method: GET
path: "/email_messages/{email_id}/recipients"
tags: ["Email Messages"]
---

# List recipients for an email message

`GET /email_messages/{email_id}/recipients`

Lists per-recipient delivery states for a single message with cursor pagination.
Each recipient has an independent status, billable flag, and lifecycle timestamps.
BCC recipient addresses are redacted (returned as null) to protect BCC privacy.
Default page size is 25, maximum is 100.

## Path parameters

- `email_id` string, uuid, required

## Query parameters

- `page_size` integer
- `page_cursor` string
- `status` 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled'
- `kind` 'to' | 'cc' | 'bcc'

## Response `200`

Paginated list of recipients.

- EmailRecipientListResponse
  - `data` EmailRecipient[], required
    - `record_type` 'email_recipient', required
    - `id` string, uuid, required — Recipient UUID.
    - `message_id` string, uuid, required — Parent email message UUID.
    - `address` string, email, nullable, required — Recipient email address. Null for BCC recipients (redacted for privacy).
    - `kind` 'to' | 'cc' | 'bcc', required
    - `status` 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled', required — Current per-recipient delivery status.
    - `billable` boolean, required — Whether this recipient's delivery is billable (set on queue acceptance).
    - `sent_at` string, date-time, nullable
    - `delivered_at` string, date-time, nullable
    - `failed_at` string, date-time, nullable
    - `smtp_code` integer, nullable — SMTP response code when available (e.g. 550 for bounces).
    - `smtp_response` string, nullable — SMTP response message when available.
  - `meta` object, required
    - `page_size` integer, required
    - `page_cursor` string, nullable — Cursor for the next page. Absent when there are no more results.

## Other responses

- `401` — Not authorized (10006).
- `404` — Resource not found (10001).

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)