Skip to main content
GET
/
v1
/
email
/
messages
/
{message_id}
/
events
Delivery event audit trail for a single email message
curl --request GET \
  --url https://api-sandbox.featherhq.com/v1/email/messages/{message_id}/events \
  --header 'x-api-key: <api-key>'
{
  "provider_message_id": "<string>",
  "delivery_status": "<string>",
  "delivery_status_at": "2023-11-07T05:31:56Z",
  "events": [
    {
      "event_type": "<string>",
      "occurred_at": "2023-11-07T05:31:56Z",
      "vendor_event_type": "<string>",
      "payload": {}
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
message_id
string
required

Response

Successful Response

All recorded events for a single outbound message.

Pairs the canonical headline state (delivery_status, delivery_status_at from the parent ConversationTurn) with the full append-only audit trail. The headline is the source of truth for "what state is the message in now"; the audit is the timeline.

​
provider_message_id
string
required
​
delivery_status
string | null
required
​
delivery_status_at
string<date-time> | null
required
​
events
MessageEventResponse · object[]