Sign in
Email Messages

List events for an email message

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.

For compatibility, each event carries the legacy customer-visible event_type (email.-prefixed), the additive canonical_event_type (email.-prefixed), and the deprecated type duplicate — whose value keeps the exact legacy format: the bare stored event name, never email.-prefixed. Gateway rejections render email.failed + canonical email.gw_reject; MTA expirations render email.bounced + canonical email.expired; every unchanged outcome carries identical event_type and canonical_event_type values (and type keeps the stored name).

get/email_messages/{email_id}/events

Path parameters

email_idstring uuid required

Email message UUID.

Query parameters

page_sizeinteger

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

page_cursorstring

Opaque URL-safe Base64 cursor returned by a previous list response.

Response

Paginated list of message events.

Example response

{
  "data": [
    {
      "event_type": "email.delivered",
      "canonical_event_type": "email.delivered"
    }
  ]
}

Changes