---
title: "Get email event statistics"
method: GET
path: "/email_events/stats"
tags: ["Email Events"]
---

# Get email event statistics

`GET /email_events/stats`

Returns counts and rates for email events over a time range. The default start time is 30 days ago.

## Query parameters

- `from` string, date-time
- `to` string, date-time

## Response `200`

Email event statistics.

- EmailEventStatsResponse
  - `data` EmailEventStats, required
    - `record_type` 'email_event_stats', required
    - `counts` EmailEventCounts, required — Recipient-level outcome counts for the queried time range. Each to, cc, and bcc recipient counts separately; repeated events of the same type for the same message and recipient count once. Partial MTA injection results count successful recipients as sent and unsuccessful recipients as failed. Only the ten listed event types are counted; other valid event types (scheduled, cancelled, sandbox, sending, rejected) are not included in stats.
      - `queued` integer, required
      - `sent` integer, required
      - `delivered` integer, required
      - `deferred` integer, required
      - `bounced` integer, required
      - `opened` integer, required
      - `clicked` integer, required
      - `complained` integer, required
      - `unsubscribed` integer, required
      - `failed` integer, required
    - `rates` EmailEventRates, required — Recipient-level event rates as percentages, rounded to 2 decimal places.
      - `delivery_rate` number, float, required — Delivered recipients / queued recipients as a percentage.
      - `bounce_rate` number, float, required — Bounced recipients / queued recipients as a percentage.
      - `deferred_rate` number, float, required — Deferred recipients / queued recipients as a percentage.
      - `open_rate` number, float, required — Recipients opened / recipients delivered as a percentage.
      - `click_rate` number, float, required — Recipients clicked / recipients opened as a percentage.
      - `complaint_rate` number, float, required — Recipients with a complaint feedback report / delivered recipients as a percentage.
    - `time_range` TimeRange, required
      - `from` string, date-time, nullable, required
      - `to` string, date-time, nullable, required

## Other responses

- `401` — Not authorized (10006).

---

[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)