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

# List events for an email message

`GET /email_messages/{email_id}/events`

Lists events for a single message sorted oldest first by `occurred_at asc, id asc`.
The legacy `/v2/emails/{id}/events` GET route is a backward-compatible alias.

## Path parameters

- `email_id` string, uuid, required

## Query parameters

- `page_size` integer
- `page_cursor` string

## Response `200`

Paginated list of message events.

- MessageEventListResponse
  - `data` MessageEvent[], required
    - `type` 'queued' | 'deferred' | 'scheduled' | 'cancelled' | 'sandbox' | 'sending' | 'sent' | 'failed' | 'delivered' | 'bounced' | 'complained' | 'rejected' | 'opened' | 'clicked' | 'unsubscribed' | 'daily_limit_exceeded', required
    - `occurred_at` string, date-time, required
    - `payload` object
  - `meta` EmailPaginationMeta, required
    - `page_size` integer, required
    - `page_cursor` string — Cursor for the next page, when more results are available.

## Other responses

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

## Changes

> 78 revisions in range; 1 not diffed.

- **2026-09-22** `9621f6123ebc` — 4 warning
  - added the new `10011` enum value to the `errors/items/code` response property for the response status `401`
  - added the new `10011` enum value to the `errors/items/code` response property for the response status `404`
  - added the new `domain_graduation_limit_exceeded` enum value to the `errors/items/code` response property for the response status `401`
  - added the new `domain_graduation_limit_exceeded` enum value to the `errors/items/code` response property for the response status `404`
- **2026-07-28** `b1bf96d8391e` — 1 warning
  - added the new `daily_limit_exceeded` enum value to the `data/items/type` response property for the response status `200`
- **2026-07-16** `2fb3b617430a` — 4 warning, 2 info
  - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `401`
  - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `404`
  - added the new `reputation_suspended` enum value to the `errors/items/code` response property for the response status `401`
  - added the new `reputation_suspended` enum value to the `errors/items/code` response property for the response status `404`
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/email_messages/:email_id/events/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/950384d11a37?raw)