Mailfully logo

Retrieve a received email

GEThttps://api.mailfully.com/v1/emails/receiving/{id}

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.

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 received email id (inb_ followed by a 26-character ULID).

Query Parameters

html_format"data_uri" | "cid"default: data_uri

How cid: image links in html are returned.

Allowed values: "data_uri" | "cid"
Default: "data_uri"

Response

application/json

The received email.