Skip to main content
GET
JavaScript

Authorizations

Authorization
string
header
required

Telnyx API key supplied as Authorization: Bearer <token>. In production, auth may be validated by the API gateway and forwarded via Telnyx auth headers.

Query Parameters

page_size
integer
default:25

Number of results to return. Defaults to 25; maximum is 100. Invalid values are clamped to the valid range.

Required range: 1 <= x <= 100
page[cursor]
string

Opaque URL-safe Base64 cursor returned by a previous event list response. The legacy page[after] and flat page_cursor forms are also accepted.

event_type

Comma-separated list of event types to include. Also accepts repeated query parameters (e.g. event_type=delivered&event_type=bounced). Unknown values return no matches.

Dual-name compatibility: values are accepted bare or email.-prefixed. A legacy value keeps matching the rows it matched pre-rename — no widening: failed also matches the rows that now store the canonical names of the outcomes it covered (gw_reject, injection_timeout, expired); bounced matches stored bounced rows only (recipient-scoped Expirations stored failed pre-rename and never matched bounced, so expired is deliberately not a bounced expansion). A canonical value matches its own rows plus legacy rows whose recorded payload evidence proves that outcome (expired also surfaces legacy bounced rows with bounce_category: transient). The additive canonical_event_type field in each response row names the canonical outcome.

email_id
string<uuid>

Filter events for a specific email message UUID. Invalid UUID values are silently ignored (no filter applied).

from
string<date-time>

Inclusive ISO 8601 start timestamp. Defaults to 30 days ago when omitted.

to
string<date-time>

Inclusive ISO 8601 end timestamp. When from is provided without to, defaults to from + 30 days.

Response

Paginated list of account email events.

data
object[]
required
meta
object
required