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, except recipients, which is an array of strings on bounce and complaint events.