Retrieve a received email
Retrieve one received email with its body, headers, receipt verdicts, attachment metadata, and a download link for the original MIME.
By default (html_format=data_uri) every cid: image link in html that matches a stored attachment is replaced with a data: URI, up to 5 MB of images in total; past that, or with no match, the cid: link is left as is. html_format=cid returns the original links.
An email whose virus verdict is FAIL returns metadata only: html, text, and raw are null and headers is empty. On a paid plan, an email that arrived over the plan's monthly ceiling or spend cap returns 403 email_above_quota until the organization's usage is back within both. Free mail is never locked: from December 1, 2026, mail past Free's limit is deleted on arrival instead. An unknown id, another organization's id, and an email past the retention window all return the same 404. Requires the read:inbound scope.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The received email id (inb_ followed by a 26-character ULID).
Query Parameters
How cid: image links in html are returned.
"data_uri" | "cid""data_uri"Response
The received email.
