List email events

GEThttps://api.mailfully.com/v1/emails/{id}/events

Return the event timeline for one message, oldest first. The parent message is resolved first with the same org/environment/retention 404 semantics as getting an email. Each event carries a lowercase type, an event_at timestamp, and a per-type detail allowlist (null for types without extra detail). Requires the send or read:emails scope.

Loading code example

Loading code example

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

idstringrequired

The message id (a bare 26-character ULID, no prefix).

Response

application/json

The event timeline.

dataarray<object>required

The event timeline, oldest first.

data.typestringrequired

Lowercase event type: `send`, `delivery`, `bounce`, `complaint`, `reject`, `renderingfailure`, `deliverydelay`, `open`, `click`, plus the synthetic `suppressed` and `quarantined`.

data.event_atstring<date-time>required

data.detailobjectrequired

Per-type detail allowlist; `null` for event types without extra detail. Every field is a string or null.