Get Received Email
Retrieve the full details of a single received (inbound) email, including its HTML/text content.
/emails/receiving/{email_id}Requires an API key with the received_emails:read permission.
Path Parameters
email_idstringrequiredThe received email ID (UUID).
Query Parameters
html_formatstringHow inline images appear in html. data_uri (the default) returns them as base64 data: URIs; cid keeps the original <img src="cid:..."> references, each matching the content_id of an attachment.
Response Fields
objectstringAlways "email".
idstringThe email ID.
tostring[]Recipient email addresses.
fromstringSender email address.
subjectstringEmail subject.
htmlstring | nullHTML content of the email.
textstring | nullPlain text content of the email.
bccstring[]BCC recipients.
ccstring[]CC recipients.
reply_tostring[]Reply-to addresses.
received_forstring[]The envelope recipients the message was delivered to. This can differ from to — for Bcc, forwarded and mailing-list mail. Empty for emails received before this field was recorded.
message_idstring | nullThe original SMTP message ID.
headersobject | nullThe message's headers, keyed by lower-cased name. A repeated header (such as received) has its values joined with , in message order. null for emails received before headers were recorded.
rawobject | nullThe message exactly as received. download_url is a signed URL that needs no API key and expires at expires_at, one hour after the request. null for emails received before the raw message was stored. The Resend SDK's emails.receiving.forward downloads it.
attachmentsarrayArray of attachment metadata objects. Each item contains id, filename, size, content_type, content_disposition, and content_id.
created_atstringISO 8601 timestamp when the email was received.
curl -X GET 'https://api.postflare.dev/emails/receiving/9f8e7d6c-5b4a-3210-fedc-ba9876543210' \
-H 'Authorization: Bearer sk_xxxxxxxxx'const response = await fetch(
'https://api.postflare.dev/emails/receiving/9f8e7d6c-5b4a-3210-fedc-ba9876543210',
{
headers: {
'Authorization': 'Bearer sk_xxxxxxxxx',
},
}
);
const data = await response.json();Response
{
"object": "email",
"id": "9f8e7d6c-5b4a-3210-fedc-ba9876543210",
"to": ["support@acme.com"],
"from": "user@example.com",
"created_at": "2026-01-01T00:00:00.000Z",
"subject": "Help request",
"html": "<p>I need help with my account.</p>",
"text": "I need help with my account.",
"bcc": [],
"cc": [],
"reply_to": [],
"received_for": ["receive+acme@inbound.postflare.dev"],
"message_id": "<unique-message-id@mail.example.com>",
"headers": {
"from": "user@example.com",
"subject": "Help request",
"mime-version": "1.0"
},
"raw": {
"download_url": "https://<storage-host>/received-emails/9f8e7d6c-5b4a-3210-fedc-ba9876543210/raw.eml?X-Amz-Signature=...",
"expires_at": "2026-01-01T01:00:00.000Z"
},
"attachments": []
}