Emails (raw MIME)

Use this endpoint when an agent or integration needs the full original MIME (headers and body exactly as received), for example archival, forwarding, or header analysis not present in parsed fields.

For the same bytes inside MCP hosts, use the get_email_raw tool (base64 JSON) instead of this streaming REST response.

Base path

https://momail.io/v1/api/emails/{messageId}/raw

Authentication: Authorization: Bearer <api-key>. See Authentication.

Download raw MIME

GET /v1/api/emails/{messageId}/raw

Parameter	Location	Description
`messageId`	path	Email `message_id` in MoMail (same id used by MCP `get_email` / `get_email_raw` as `email_id`)

Success response

HTTP 200

Header	Value
`Content-Type`	`message/rfc822`
`Content-Disposition`	`attachment; filename="{messageId}.eml"`
`X-MoMail-R2-Key`	Internal storage key (for support/debug)

Body: raw .eml bytes (not JSON).

Errors

HTTP 404 — email not found or not owned by the authenticated user:

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Email not found"
  }
}

HTTP 401 — missing or invalid API key / token (see Error codes).

Code examples

curl -L "https://momail.io/v1/api/emails/msg_abc123/raw" \
  -H "Authorization: Bearer your_api_key" \
  -o msg_abc123.eml

const res = await fetch(
  'https://momail.io/v1/api/emails/msg_abc123/raw',
  { headers: { Authorization: `Bearer ${process.env.MOMAIL_API_KEY}` } }
);
if (!res.ok) throw new Error(await res.text());
const eml = await res.arrayBuffer();
// eml is RFC 822 bytes

import requests

r = requests.get(
    'https://momail.io/v1/api/emails/msg_abc123/raw',
    headers={'Authorization': 'Bearer your_api_key'},
)
r.raise_for_status()
with open('msg_abc123.eml', 'wb') as f:
    f.write(r.content)