Mailfully logo

Retrieve a received email

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

Retrieve one received email with its body, headers, SES 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. 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. 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.