Get a message

Fetch a single message by ID from a mailbox identified by its full email address. Messages classified as authentication mail (OTP, password reset, magic link) come back with subject/body redacted unless the token has the email:auth_secrets scope.

get/api/emails/{address}/messages/{id}

Request

Base URL: https://domani.run
URL: https://domani.run/api/emails/{address}/messages/{id}
Auth: HTTP bearer

Path parameters

addressstring required

Mailbox email address (URL-encoded)

idstring required

Message ID

Response

Message details

idstring

thread_idstring

Conversation id shared by every message of the thread (the root message id)

labelsstring[]

Every label on the message; label is the first one

thread_keystring

Canonical backend-namespaced conversation key

thread_aliasesstring[]

Legacy workflow keys to pass back when mutating conversation state

message_idstring nullable

direction'in' | 'out'

fromstring

The sender's display name and address from the From header (e.g. 'Alice alice@example.com'), or the bare address when the mail carried no name.

avatar_urlstring uri nullable

Privacy-preserving Domani proxy URL for the sender avatar

tostring

Every To recipient from the header, with display names, in the order the sender wrote them (not only the envelope address that routed this mail to the mailbox).

ccstring nullable

Every Cc recipient from the header, with display names, or null when the mail carried no Cc.

bccstring nullable

Bcc recipients, present only on your own outbound message (never on one you received, and never delivered as a header).

reply_tostring nullable

subjectstring

textstring nullable

htmlstring nullable

in_reply_tostring nullable

referencesstring nullable

statusstring

is_readboolean

read_atstring nullable

created_atstring date-time

Changes

No recorded changes to this operation across all 2 revisions of this API.