Get a single message
Returns the full structured message — parsed sender/recipients, `text`/ `html` bodies, the reply-history-stripped `extracted_*`, `headers`, threading headers, and the attachment list. A `spam`-labeled message requires the key's `label_spam_read` permission. Unknown/cross-tenant inbox or message ids return an indistinguishable `404`.
Returns the full structured message — parsed sender/recipients, text/
html bodies, the reply-history-stripped extracted_*, headers,
threading headers, and the attachment list. A spam-labeled message
requires the key's label_spam_read permission. Unknown/cross-tenant
inbox or message ids return an indistinguishable 404.
The per-tenant API key. Sent as the x-api-key request header. The key
is tenant-scoped.
In: header
Path Parameters
The inbox's email address (the external inbox identifier).
The message id.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/inboxes/user@example.com/messages/string"{ "message_id": "string", "thread_id": "string", "inbox_id": "user@example.com", "labels": [ "string" ], "from": "string", "to": [ "string" ], "cc": [ "string" ], "bcc": [ "string" ], "reply_to": [ "string" ], "subject": "string", "text": "string", "html": "string", "extracted_text": "string", "extracted_html": "string", "preview": "string", "headers": {}, "in_reply_to": "string", "references": [ "string" ], "size": 0, "timestamp": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "attachments": [ { "attachment_id": "string", "filename": "string", "content_type": "string", "size": 0, "content_disposition": "string", "content_id": "string" } ]}{ "name": "string", "message": "string"}{ "name": "string", "message": "string"}{ "name": "string", "message": "string"}Get an attachment download URL GET
Returns the attachment's metadata plus a short-lived presigned `download_url` — the client fetches the bytes from that URL. The URL expires (`expires_at`); re-call this endpoint to mint a fresh one. Unknown/cross-tenant ids return an indistinguishable `404`.
Get the raw RFC-822 message GET
Returns the raw RFC-822 (`.eml`) source of a message as a short-lived presigned `download_url` — the client fetches the untouched bytes from that URL, exactly as attachment download works. A `spam`-labeled message requires the key's `label_spam_read` permission. Unknown/cross-tenant ids return an indistinguishable `404`.