---
title: "List account email events"
method: GET
path: "/email_events"
tags: ["Email Events"]
---

# List account email events

`GET /email_events`

Lists account-level email events sorted oldest first by `occurred_at asc, id asc`.

## Query parameters

- `page_size` integer
- `page_cursor` string
- `event_type` union
  - string
  - string[]
- `email_id` string, uuid
- `from` string, date-time
- `to` string, date-time

## Response `200`

Paginated list of account email events.

- AccountEmailEventListResponse
  - `data` AccountEmailEvent[], required
    - `email` EventEmailSummary
      - `cc` EmailAddress[], required
        - `email` string, required
        - `name` string
      - `from` EmailAddress, required
        - `email` string, required
        - `name` string
      - `subject` string, required
      - `to` EmailAddress[], required
        - `email` string, required
        - `name` string
    - `email_id` string, uuid, required
    - `id` string, uuid, required
    - `occurred_at` string, date-time, required
    - `payload` object
    - `record_type` 'email_event', required
    - `type` 'queued' | 'deferred' | 'scheduled' | 'cancelled' | 'sandbox' | 'sending' | 'sent' | 'failed' | 'delivered' | 'bounced' | 'complained' | 'rejected' | 'opened' | 'clicked' | 'unsubscribed' | 'daily_limit_exceeded', required
  - `meta` EventPaginationMeta, required
    - `page_cursor` string — Cursor for the next page, when more results are available.
    - `page_size` integer, required
    - `time_range` TimeRange, required
      - `from` string, date-time, nullable, required
      - `to` string, date-time, nullable, required

## Other responses

- `401` — Not authorized (10006).

## Changes

- **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` — 2 warning, 1 info
  - added the new `recipient_suppressed` 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 `401`
  - added the optional property `suppressed` to the response with the `401` status
- **2026-07-12** `b3c5aebde44c` — 2 warning
  - added the new `10027` enum value to the `errors/items/code` response property for the response status `401`
  - added the new `10036` enum value to the `errors/items/code` response property for the response status `401`
- **2026-07-07** `6ef0ae248bf7` — 1 info
  - endpoint added
- **2026-07-02** `224ed0d8a5c3` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/email_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-service-production.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)