{
"error": {
"type": "invalid_request_error",
"code": "body_too_large",
"message": "The message is too large to return its body inline.",
"status": 413,
"requestId": "e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"
}
}
{
"error": {
"type": "rate_limit_error",
"code": "rate_limited",
"message": "Too many requests. Retry after the interval in the Retry-After header.",
"status": 429,
"requestId": "e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f",
"retryAfter": 30
}
}
{
"error": {
"type": "api_error",
"code": "upstream_unavailable",
"message": "A dependency is temporarily unavailable.",
"status": 503,
"requestId": "e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"
}
}
Emails
Get an email
Fetch one email with its body – the only endpoint that returns the body. A null body means none was stored; if the stored body can’t be read right now the call returns 503 rather than a false empty.
Requires one of the following scopes: emails:read, emails:all, all:read, all:all.
{
"error": {
"type": "invalid_request_error",
"code": "body_too_large",
"message": "The message is too large to return its body inline.",
"status": 413,
"requestId": "e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"
}
}
{
"error": {
"type": "rate_limit_error",
"code": "rate_limited",
"message": "Too many requests. Retry after the interval in the Retry-After header.",
"status": 429,
"requestId": "e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f",
"retryAfter": 30
}
}
{
"error": {
"type": "api_error",
"code": "upstream_unavailable",
"message": "A dependency is temporarily unavailable.",
"status": 503,
"requestId": "e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"
}
}
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
id
string<uuid>
required
Response
id
string
required
Example:
"8c5a1e07-2b93-4d6f-a0e8-7c4b9d1f2a36"
threadId
string | null
required
Conversation this email belongs to. null when the email is not part of a conversation. An opaque identifier: pass it back as-is, do not parse or construct it.
Short preview of the message. Always present in list results.
Example:
"Thanks for the details, this works for us."
isUnread
boolean | null
required
Read state. null when the email is not part of a conversation and therefore has no read state, which is not the same as read.
Example:
true
type
enum<string>
required
Available options:
sent,
received
Example:
"received"
campaignId
string | null
required
Campaign of the email. For an email of a subsequence - its main campaign (see subsequence).
Example:
"c1f3b0a2-6d4e-4f8b-9a1c-2e5d7f0a3b6c"
leadId
string | null
required
Lead of the email in that campaign (/v1/campaigns/{campaignId}/leads/{leadId}). null when the lead no longer exists.
Example:
"9d4e2f10-5b6a-4c73-8e19-0f2a7c4d8b31"
subsequence
object | null
required
Set when the email belongs to a subsequence of the campaign (/v1/subsequences/{id}); null otherwise.
Show child attributes
hasAttachments
boolean
required
Example:
false
receivedAt
string<date-time>
required
Example:
"2026-07-13T09:24:11.000Z"
sentAt
string<date-time> | null
required
Example:
"2026-07-13T09:24:09.000Z"
body
object
required
The message body. Returned only here, never in list results. A null field means that part was never stored for this message. It does NOT mean we failed to read it: if the stored body is unreadable right now, the call returns 503 instead, so a 200 always carries the real content.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"MailBeast API","description":"Task-shaped REST API for cold email at scale - campaigns, leads, deliverability, verification and lead discovery.","colors":{"primary":"#2F62E8","light":"#5D8DF6","dark":"#1E46B0"},"logo":{"light":"https://mintcdn.com/mail-beast-ai/wTQEP6MPos1XZJQD/logo/light.svg?fit=max\u0026auto=format\u0026n=wTQEP6MPos1XZJQD\u0026q=85\u0026s=aeac906ba6340f321596e4d877c72bf1","dark":"https://mintcdn.com/mail-beast-ai/wTQEP6MPos1XZJQD/logo/dark.svg?fit=max\u0026auto=format\u0026n=wTQEP6MPos1XZJQD\u0026q=85\u0026s=d545596dc15a153ea80a91602ce3bf0c"},"favicon":"https://mintcdn.com/mail-beast-ai/wTQEP6MPos1XZJQD/favicon.png?fit=max\u0026auto=format\u0026n=wTQEP6MPos1XZJQD\u0026q=85\u0026s=375d802479a055444b3bbd6544d40be9","navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://app.mailbeast.ai"}},"footer":{"socials":{"website":"https://mailbeast.ai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mail-beast-ai","hasAudioNarration":false,"actualSubdomain":"mail-beast-ai","customDomains":["developer.mailbeast.ai"],"gitSource":{"type":"github","owner":"mark-digital-llc","repo":"mailbeast-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af776fbc76c417ce96f6409","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":55},{"language":"default","tag":"Guides","count":13},{"language":"default","tag":"Email Accounts","count":11},{"language":"default","tag":"Campaigns","count":10},{"language":"default","tag":"Subsequences","count":9},{"language":"default","tag":"Resources","count":8},{"language":"default","tag":"Leads","count":7},{"language":"default","tag":"Emails","count":6},{"language":"default","tag":"Get started","count":5},{"language":"default","tag":"Workspace","count":4}],"searchSettings":{"showContentSnippets":false}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/emails/get-an-email","slug":"/api-reference/emails/get-an-email","pageMetadata":{"title":"Get an email","description":"Fetch one email with its body – the only endpoint that returns the body. A `null` body means none was stored; if the stored body can't be read right now the call returns `503` rather than a false empty.\n\nRequires one of the following scopes: `emails:read`, `emails:all`, `all:read`, `all:all`.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/emails/{id}","href":"/api-reference/emails/get-an-email","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Fetch one email with its body – the only endpoint that returns the body. A \", _jsx(_components.code, {\n children: \"null\"\n }), \" body means none was stored; if the stored body can’t be read right now the call returns \", _jsx(_components.code, {\n children: \"503\"\n }), \" rather than a false empty.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Requires one of the following scopes: \", _jsx(_components.code, {\n children: \"emails:read\"\n }), \", \", _jsx(_components.code, {\n children: \"emails:all\"\n }), \", \", _jsx(_components.code, {\n children: \"all:read\"\n }), \", \", _jsx(_components.code, {\n children: \"all:all\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get an email","description":"Fetch one email with its body – the only endpoint that returns the body. A `null` body means none was stored; if the stored body can't be read right now the call returns `503` rather than a false empty.\n\nRequires one of the following scopes: `emails:read`, `emails:all`, `all:read`, `all:all`.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/emails/{id}","href":"/api-reference/emails/get-an-email","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Fetch one email with its body – the only endpoint that returns the body. A `null` body means none was stored; if the stored body can't be read right now the call returns `503` rather than a false empty.\n\nRequires one of the following scopes: `emails:read`, `emails:all`, `all:read`, `all:all`.","operationId":"emails_getOne","parameters":["16eef947-1cf7-4a36-a175-538f98eb8f8c"],"responses":{"200":"532bb25d-51de-4a6c-b63e-3f96bf33ca41","401":"7c1ba7a8-ae10-424b-934f-abbe766a96e6","403":"4572156c-35ac-481b-8ff6-03f37c36d757","404":"87af6b34-66a2-48cf-86ce-e848f179ab2e","413":"a63b38e8-4310-4680-8129-886f7c380f85","429":"16024114-7c5d-446f-8107-68c15c25835d","503":"179404bd-a3b4-4de6-a73f-f697648024c0"},"security":["37a3b9e6-78c5-4fe2-8d89-2bfbcb4fbf88"],"summary":"Get an email","tags":["Emails"],"method":"get","type":"path","servers":["93e0febf-83bf-4fa8-affd-7a1e0adcbf2c"],"path":"/v1/emails/{id}","baseUrlOptions":["https://api.mailbeast.ai"],"title":"Get an email","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"16eef947-1cf7-4a36-a175-538f98eb8f8c":{"name":"id","required":true,"in":"path","schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"532bb25d-51de-4a6c-b63e-3f96bf33ca41":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"8c5a1e07-2b93-4d6f-a0e8-7c4b9d1f2a36","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","example":"13a265fd-f0f2-b1d1-d6fc-154e483183e7","description":"Conversation this email belongs to. `null` when the email is not part of a conversation. An opaque identifier: pass it back as-is, do not parse or construct it.","isRequired":true,"uniqueKey":"threadId.oneOf.0","typeLabel":"string"},{"type":"null","example":"13a265fd-f0f2-b1d1-d6fc-154e483183e7","description":"Conversation this email belongs to. `null` when the email is not part of a conversation. An opaque identifier: pass it back as-is, do not parse or construct it.","isRequired":true,"uniqueKey":"threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"threadId","typeLabel":"string | null"},"messageId":{"oneOf":[{"type":"string","example":"\[email protected]>","description":"RFC 5322 Message-ID as set by the sending server.","isRequired":true,"uniqueKey":"messageId.oneOf.0","typeLabel":"string"},{"type":"null","example":"\[email protected]>","description":"RFC 5322 Message-ID as set by the sending server.","isRequired":true,"uniqueKey":"messageId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"messageId","typeLabel":"string | null"},"mailbox":{"oneOf":[{"type":"object","description":"The mailbox of yours that sent or received this email.","required":["id","email"],"properties":{"id":{"type":"string","example":"3f1c2b7e-9a4d-4c8e-b1f6-5d2a7e0c3b94","isRequired":true,"uniqueKey":"mailbox.oneOf.0.id","typeLabel":"string"},"email":{"type":"string","example":"[email protected]","isRequired":true,"uniqueKey":"mailbox.oneOf.0.email","typeLabel":"string"}},"isRequired":true,"uniqueKey":"mailbox.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"mailbox.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"mailbox","typeLabel":"object | null"},"from":{"type":"object","properties":{"email":{"type":"string","example":"[email protected]","isRequired":true,"uniqueKey":"from.email","typeLabel":"string"},"name":{"oneOf":[{"type":"string","example":"John Carter","isRequired":true,"uniqueKey":"from.name.oneOf.0","typeLabel":"string"},{"type":"null","example":"John Carter","isRequired":true,"uniqueKey":"from.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"from.name","typeLabel":"string | null"}},"required":["email","name"],"isRequired":true,"uniqueKey":"from","typeLabel":"object"},"to":{"example":["[email protected]"],"type":"array","items":{"type":"string","uniqueKey":"to.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"to","typeLabel":"string[]"},"cc":{"example":[],"type":"array","items":{"type":"string","uniqueKey":"cc.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"cc","typeLabel":"string[]"},"bcc":{"example":[],"type":"array","items":{"type":"string","uniqueKey":"bcc.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"bcc","typeLabel":"string[]"},"subject":{"type":"string","example":"Re: Pricing question","isRequired":true,"uniqueKey":"subject","typeLabel":"string"},"snippet":{"oneOf":[{"type":"string","example":"Thanks for the details, this works for us.","description":"Short preview of the message. Always present in list results.","isRequired":true,"uniqueKey":"snippet.oneOf.0","typeLabel":"string"},{"type":"null","example":"Thanks for the details, this works for us.","description":"Short preview of the message. Always present in list results.","isRequired":true,"uniqueKey":"snippet.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"snippet","typeLabel":"string | null"},"isUnread":{"oneOf":[{"type":"boolean","example":true,"description":"Read state. `null` when the email is not part of a conversation and therefore has no read state, which is not the same as read.","isRequired":true,"uniqueKey":"isUnread.oneOf.0","typeLabel":"boolean"},{"type":"null","example":true,"description":"Read state. `null` when the email is not part of a conversation and therefore has no read state, which is not the same as read.","isRequired":true,"uniqueKey":"isUnread.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"isUnread","typeLabel":"boolean | null"},"type":{"type":"string","enum":["sent","received"],"example":"received","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"campaignId":{"oneOf":[{"type":"string","example":"c1f3b0a2-6d4e-4f8b-9a1c-2e5d7f0a3b6c","description":"Campaign of the email. For an email of a subsequence - its main campaign (see `subsequence`).","isRequired":true,"uniqueKey":"campaignId.oneOf.0","typeLabel":"string"},{"type":"null","example":"c1f3b0a2-6d4e-4f8b-9a1c-2e5d7f0a3b6c","description":"Campaign of the email. For an email of a subsequence - its main campaign (see `subsequence`).","isRequired":true,"uniqueKey":"campaignId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"campaignId","typeLabel":"string | null"},"leadId":{"oneOf":[{"type":"string","example":"9d4e2f10-5b6a-4c73-8e19-0f2a7c4d8b31","description":"Lead of the email in that campaign (`/v1/campaigns/{campaignId}/leads/{leadId}`). `null` when the lead no longer exists.","isRequired":true,"uniqueKey":"leadId.oneOf.0","typeLabel":"string"},{"type":"null","example":"9d4e2f10-5b6a-4c73-8e19-0f2a7c4d8b31","description":"Lead of the email in that campaign (`/v1/campaigns/{campaignId}/leads/{leadId}`). `null` when the lead no longer exists.","isRequired":true,"uniqueKey":"leadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"leadId","typeLabel":"string | null"},"subsequence":{"oneOf":[{"type":"object","description":"Set when the email belongs to a subsequence of the campaign (`/v1/subsequences/{id}`); `null` otherwise.","required":["id","name"],"properties":{"id":{"type":"string","example":"5b2f3c4d-6e7f-4a81-9b0c-1d2e3f4a5b6c","isRequired":true,"uniqueKey":"subsequence.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","example":"Interested - book a call","isRequired":true,"uniqueKey":"subsequence.oneOf.0.name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"subsequence.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"subsequence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"subsequence","typeLabel":"object | null"},"hasAttachments":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"hasAttachments","typeLabel":"boolean"},"receivedAt":{"type":"string","format":"date-time","example":"2026-07-13T09:24:11.000Z","isRequired":true,"uniqueKey":"receivedAt","typeLabel":"string\u003cdate-time>"},"sentAt":{"oneOf":[{"type":"string","format":"date-time","example":"2026-07-13T09:24:09.000Z","isRequired":true,"uniqueKey":"sentAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","example":"2026-07-13T09:24:09.000Z","isRequired":true,"uniqueKey":"sentAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sentAt","typeLabel":"string\u003cdate-time> | null"},"body":{"type":"object","description":"The message body. Returned only here, never in list results. A `null` field means that part was never stored for this message. It does NOT mean we failed to read it: if the stored body is unreadable right now, the call returns `503` instead, so a `200` always carries the real content.","required":["html","text"],"properties":{"html":{"oneOf":[{"type":"string","example":"\u003cp>Thanks for the details, this works for us.\u003c/p>","description":"HTML body. `null` when the message has no HTML part.","isRequired":true,"uniqueKey":"body.html.oneOf.0","typeLabel":"string"},{"type":"null","example":"\u003cp>Thanks for the details, this works for us.\u003c/p>","description":"HTML body. `null` when the message has no HTML part.","isRequired":true,"uniqueKey":"body.html.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"body.html","typeLabel":"string | null"},"text":{"oneOf":[{"type":"string","example":"Thanks for the details, this works for us.","description":"Plain-text body. `null` when the message has no text part.","isRequired":true,"uniqueKey":"body.text.oneOf.0","typeLabel":"string"},{"type":"null","example":"Thanks for the details, this works for us.","description":"Plain-text body. `null` when the message has no text part.","isRequired":true,"uniqueKey":"body.text.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"body.text","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"body","typeLabel":"object"}},"required":["id","threadId","messageId","mailbox","from","to","cc","bcc","subject","snippet","isUnread","type","campaignId","leadId","subsequence","hasAttachments","receivedAt","sentAt","body"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"8c5a1e07-2b93-4d6f-a0e8-7c4b9d1f2a36","threadId":"13a265fd-f0f2-b1d1-d6fc-154e483183e7","messageId":"\[email protected]>","mailbox":{"id":"3f1c2b7e-9a4d-4c8e-b1f6-5d2a7e0c3b94","email":"[email protected]"},"from":{"email":"[email protected]","name":"John Carter"},"to":["[email protected]"],"cc":[],"bcc":[],"subject":"Re: Pricing question","snippet":"Thanks for the details, this works for us.","isUnread":true,"type":"received","campaignId":"c1f3b0a2-6d4e-4f8b-9a1c-2e5d7f0a3b6c","leadId":"9d4e2f10-5b6a-4c73-8e19-0f2a7c4d8b31","subsequence":{"id":"5b2f3c4d-6e7f-4a81-9b0c-1d2e3f4a5b6c","name":"Interested - book a call"},"hasAttachments":false,"receivedAt":"2026-07-13T09:24:11.000Z","sentAt":"2026-07-13T09:24:09.000Z","body":{"html":"\u003cp>Thanks for the details, this works for us.\u003c/p>","text":"Thanks for the details, this works for us."}}}},"exampleType":"generated"}},"exampleType":"generated"},"7c1ba7a8-ae10-424b-934f-abbe766a96e6":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","example":"authorization_error","description":"Broad error class.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","example":"permission_denied","description":"Stable machine-readable code to switch on.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"This API key is missing the required scope.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"status":{"type":"number","example":403,"isRequired":true,"uniqueKey":"error.status","typeLabel":"number"},"requestId":{"type":"string","example":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f","description":"Correlation id - quote it in support requests.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"},"details":{"description":"Field-level validation messages (present on validation errors).","example":["name should not be empty"],"type":"array","items":{"type":"string","uniqueKey":"error.details.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.details","typeLabel":"string[]"},"retryAfter":{"type":"number","description":"Seconds to wait before retrying (present on 429 responses).","example":30,"uniqueKey":"error.retryAfter","typeLabel":"number"}},"required":["type","code","message","status","requestId"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"authentication_error","code":"unauthenticated","message":"Missing or invalid API key.","status":401,"requestId":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"authentication_error","code":"unauthenticated","message":"Missing or invalid API key.","status":401,"requestId":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"}}}},"exampleType":"examples"}},"exampleType":"examples"},"4572156c-35ac-481b-8ff6-03f37c36d757":{"description":"The key lacks a required scope, or the plan does not include API access.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","example":"authorization_error","description":"Broad error class.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","example":"permission_denied","description":"Stable machine-readable code to switch on.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"This API key is missing the required scope.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"status":{"type":"number","example":403,"isRequired":true,"uniqueKey":"error.status","typeLabel":"number"},"requestId":{"type":"string","example":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f","description":"Correlation id - quote it in support requests.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"},"details":{"description":"Field-level validation messages (present on validation errors).","example":["name should not be empty"],"type":"array","items":{"type":"string","uniqueKey":"error.details.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.details","typeLabel":"string[]"},"retryAfter":{"type":"number","description":"Seconds to wait before retrying (present on 429 responses).","example":30,"uniqueKey":"error.retryAfter","typeLabel":"number"}},"required":["type","code","message","status","requestId"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"authorization_error","code":"permission_denied","message":"This API key is missing the required scope.","status":403,"requestId":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"authorization_error","code":"permission_denied","message":"This API key is missing the required scope.","status":403,"requestId":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"}}}},"exampleType":"examples"}},"exampleType":"examples"},"87af6b34-66a2-48cf-86ce-e848f179ab2e":{"description":"The resource does not exist in your workspace.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","example":"authorization_error","description":"Broad error class.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","example":"permission_denied","description":"Stable machine-readable code to switch on.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"This API key is missing the required scope.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"status":{"type":"number","example":403,"isRequired":true,"uniqueKey":"error.status","typeLabel":"number"},"requestId":{"type":"string","example":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f","description":"Correlation id - quote it in support requests.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"},"details":{"description":"Field-level validation messages (present on validation errors).","example":["name should not be empty"],"type":"array","items":{"type":"string","uniqueKey":"error.details.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.details","typeLabel":"string[]"},"retryAfter":{"type":"number","description":"Seconds to wait before retrying (present on 429 responses).","example":30,"uniqueKey":"error.retryAfter","typeLabel":"number"}},"required":["type","code","message","status","requestId"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"invalid_request_error","code":"not_found","message":"Resource not found.","status":404,"requestId":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"not_found","message":"Resource not found.","status":404,"requestId":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"}}}},"exampleType":"examples"}},"exampleType":"examples"},"a63b38e8-4310-4680-8129-886f7c380f85":{"description":"The message is too large to return its body inline. Its `snippet` is still available from the list, and the message can be opened in the dashboard.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","example":"authorization_error","description":"Broad error class.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","example":"permission_denied","description":"Stable machine-readable code to switch on.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"This API key is missing the required scope.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"status":{"type":"number","example":403,"isRequired":true,"uniqueKey":"error.status","typeLabel":"number"},"requestId":{"type":"string","example":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f","description":"Correlation id - quote it in support requests.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"},"details":{"description":"Field-level validation messages (present on validation errors).","example":["name should not be empty"],"type":"array","items":{"type":"string","uniqueKey":"error.details.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.details","typeLabel":"string[]"},"retryAfter":{"type":"number","description":"Seconds to wait before retrying (present on 429 responses).","example":30,"uniqueKey":"error.retryAfter","typeLabel":"number"}},"required":["type","code","message","status","requestId"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"invalid_request_error","code":"body_too_large","message":"The message is too large to return its body inline.","status":413,"requestId":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"body_too_large","message":"The message is too large to return its body inline.","status":413,"requestId":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"}}}},"exampleType":"examples"}},"exampleType":"examples"},"16024114-7c5d-446f-8107-68c15c25835d":{"description":"Rate limit exceeded - retry after the interval in the Retry-After header.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","example":"authorization_error","description":"Broad error class.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","example":"permission_denied","description":"Stable machine-readable code to switch on.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"This API key is missing the required scope.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"status":{"type":"number","example":403,"isRequired":true,"uniqueKey":"error.status","typeLabel":"number"},"requestId":{"type":"string","example":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f","description":"Correlation id - quote it in support requests.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"},"details":{"description":"Field-level validation messages (present on validation errors).","example":["name should not be empty"],"type":"array","items":{"type":"string","uniqueKey":"error.details.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.details","typeLabel":"string[]"},"retryAfter":{"type":"number","description":"Seconds to wait before retrying (present on 429 responses).","example":30,"uniqueKey":"error.retryAfter","typeLabel":"number"}},"required":["type","code","message","status","requestId"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"rate_limit_error","code":"rate_limited","message":"Too many requests. Retry after the interval in the Retry-After header.","status":429,"requestId":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f","retryAfter":30}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"rate_limit_error","code":"rate_limited","message":"Too many requests. Retry after the interval in the Retry-After header.","status":429,"requestId":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f","retryAfter":30}}}},"exampleType":"examples"}},"exampleType":"examples"},"179404bd-a3b4-4de6-a73f-f697648024c0":{"description":"A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","example":"authorization_error","description":"Broad error class.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","example":"permission_denied","description":"Stable machine-readable code to switch on.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"This API key is missing the required scope.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"status":{"type":"number","example":403,"isRequired":true,"uniqueKey":"error.status","typeLabel":"number"},"requestId":{"type":"string","example":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f","description":"Correlation id - quote it in support requests.","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"},"details":{"description":"Field-level validation messages (present on validation errors).","example":["name should not be empty"],"type":"array","items":{"type":"string","uniqueKey":"error.details.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.details","typeLabel":"string[]"},"retryAfter":{"type":"number","description":"Seconds to wait before retrying (present on 429 responses).","example":30,"uniqueKey":"error.retryAfter","typeLabel":"number"}},"required":["type","code","message","status","requestId"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"api_error","code":"upstream_unavailable","message":"A dependency is temporarily unavailable.","status":503,"requestId":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"api_error","code":"upstream_unavailable","message":"A dependency is temporarily unavailable.","status":503,"requestId":"e4f1c0b2-6a3d-4b8e-9f21-0a1b2c3d4e5f"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"37a3b9e6-78c5-4fe2-8d89-2bfbcb4fbf88":{"ApiKey":{"scheme":"bearer","bearerFormat":"mb_live_…","type":"http","scopes":[],"schemeName":"ApiKey"}}},"servers":{"93e0febf-83bf-4fa8-affd-7a1e0adcbf2c":{"url":"https://api.mailbeast.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","bearerFormat":"mb_live_…","type":"http","scopes":[],"schemeName":"ApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKey","name":"Authorization"}],"title":"ApiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"mail-beast-ai","siteName":"MailBeast API","title":"Get an email - MailBeast API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T20:45:51.683Z","originalFileLocation":"api-reference/emails/get-an-email.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Fetch one email with its body – the only endpoint that returns the body. A null body means none was stored; if the stored body can\u0026#x27;t be read right now the call returns 503 rather than a false empty. Requires one of the following scopes: emails:read, emails:all, all:read, all:all.\">\u003cmeta data-mint-head name=\"application-name\" content=\"MailBeast API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mail-beast-ai/WJNHEBup3U7XmwP7/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/mail-beast-ai/WJNHEBup3U7XmwP7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mail-beast-ai/WJNHEBup3U7XmwP7/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mail-beast-ai/WJNHEBup3U7XmwP7/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mail-beast-ai/WJNHEBup3U7XmwP7/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mail-beast-ai/WJNHEBup3U7XmwP7/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mail-beast-ai/WJNHEBup3U7XmwP7/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mail-beast-ai/WJNHEBup3U7XmwP7/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mail-beast-ai/WJNHEBup3U7XmwP7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get an email - MailBeast API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Fetch one email with its body – the only endpoint that returns the body. A null body means none was stored; if the stored body can\u0026#x27;t be read right now the call returns 503 rather than a false empty. Requires one of the following scopes: emails:read, emails:all, all:read, all:all.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MailBeast API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.mailbeast.ai/api-reference/emails/get-an-email\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mail-beast-ai.mintlify.site/_mintlify/api/og/v2?division=Emails\u0026amp;title=Get+an+email\u0026amp;description=Fetch+one+email+with+its+body+%E2%80%93+the+only+endpoint+that+returns+the+body.+A+%60null%60+body+means+none+was+stored%3B+if+the+stored+body+can%27t+be+read+right+now+the+cal\u0026amp;theme=cdb7d5aed92b501f19746cfc\u0026amp;signature=3fac09f649bff5ae377e68492cdf3418fe5a36301c0a079672543e6424b45e94\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get an email - MailBeast API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Fetch one email with its body – the only endpoint that returns the body. A null body means none was stored; if the stored body can\u0026#x27;t be read right now the call returns 503 rather than a false empty. Requires one of the following scopes: emails:read, emails:all, all:read, all:all.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mail-beast-ai.mintlify.site/_mintlify/api/og/v2?division=Emails\u0026amp;title=Get+an+email\u0026amp;description=Fetch+one+email+with+its+body+%E2%80%93+the+only+endpoint+that+returns+the+body.+A+%60null%60+body+means+none+was+stored%3B+if+the+stored+body+can%27t+be+read+right+now+the+cal\u0026amp;theme=cdb7d5aed92b501f19746cfc\u0026amp;signature=3fac09f649bff5ae377e68492cdf3418fe5a36301c0a079672543e6424b45e94\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/mail-beast-ai/WJNHEBup3U7XmwP7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MailBeast API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2F62E8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.mailbeast.ai/api-reference/emails/get-an-email\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/emails/get-an-email.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.mailbeast.ai/#organization\",\"name\":\"MailBeast API\",\"url\":\"https://developer.mailbeast.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mail-beast-ai/wTQEP6MPos1XZJQD/logo/light.svg?fit=max\u0026auto=format\u0026n=wTQEP6MPos1XZJQD\u0026q=85\u0026s=aeac906ba6340f321596e4d877c72bf1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.mailbeast.ai#website\",\"name\":\"MailBeast API\",\"url\":\"https://developer.mailbeast.ai\",\"publisher\":{\"@id\":\"https://developer.mailbeast.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.mailbeast.ai/api-reference/emails/get-an-email#webpage\",\"url\":\"https://developer.mailbeast.ai/api-reference/emails/get-an-email\",\"name\":\"Get an email\",\"description\":\"Fetch one email with its body – the only endpoint that returns the body. A null body means none was stored; if the stored body can't be read right now the call returns 503 rather than a false empty. Requires one of the following scopes: emails:read, emails:all, all:read, all:all.\",\"dateModified\":\"2026-11-13T20:45:51.683Z\",\"isPartOf\":{\"@id\":\"https://developer.mailbeast.ai#website\"},\"breadcrumb\":{\"@id\":\"https://developer.mailbeast.ai/api-reference/emails/get-an-email#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.mailbeast.ai/api-reference/emails/get-an-email#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Emails\",\"item\":\"https://developer.mailbeast.ai/api-reference/emails/list-emails\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get an email\",\"item\":\"https://developer.mailbeast.ai/api-reference/emails/get-an-email\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.mailbeast.ai/api-reference/emails/get-an-email#apireference\",\"headline\":\"Get an email\",\"name\":\"Get an email\",\"description\":\"Fetch one email with its body – the only endpoint that returns the body. A null body means none was stored; if the stored body can't be read right now the call returns 503 rather than a false empty. Requires one of the following scopes: emails:read, emails:all, all:read, all:all.\",\"url\":\"https://developer.mailbeast.ai/api-reference/emails/get-an-email\",\"mainEntityOfPage\":{\"@id\":\"https://developer.mailbeast.ai/api-reference/emails/get-an-email#webpage\"},\"dateModified\":\"2026-11-13T20:45:51.683Z\",\"publisher\":{\"@id\":\"https://developer.mailbeast.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.mailbeast.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"MailBeast API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"MailBeast API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/emails/get-an-email.md","siteName":"MailBeast API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Lead Finder","pages":[{"title":"List lead searches","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/lead-searches","href":"/api-reference/lead-finder/list-lead-searches"},{"title":"Get a lead search","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/lead-searches/{id}","href":"/api-reference/lead-finder/get-a-lead-search"}]},{"group":"Email Accounts","pages":[{"title":"Connect mailboxes","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/accounts","href":"/api-reference/email-accounts/connect-mailboxes"},{"title":"List mailboxes","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/accounts","href":"/api-reference/email-accounts/list-mailboxes"},{"title":"Get a mailbox","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/accounts/{id}","href":"/api-reference/email-accounts/get-a-mailbox"},{"title":"Update a mailbox","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/accounts/{id}","href":"/api-reference/email-accounts/update-a-mailbox"},{"title":"Delete a mailbox","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/accounts/{id}","href":"/api-reference/email-accounts/delete-a-mailbox"},{"title":"Bulk update mailboxes","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/accounts/bulk","href":"/api-reference/email-accounts/bulk-update-mailboxes"},{"title":"Verification result","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/accounts/{id}/verification","href":"/api-reference/email-accounts/verification-result"},{"title":"Pause a mailbox","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/accounts/{id}/pause","href":"/api-reference/email-accounts/pause-a-mailbox"},{"title":"Resume a mailbox","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/accounts/{id}/resume","href":"/api-reference/email-accounts/resume-a-mailbox"},{"title":"Start OAuth connect","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/accounts/oauth/{provider}/init","href":"/api-reference/email-accounts/start-oauth-connect"},{"title":"Poll OAuth connect","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/accounts/oauth/{provider}/status","href":"/api-reference/email-accounts/poll-oauth-connect"}]},{"group":"Campaigns","pages":[{"title":"Create a campaign","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/campaigns","href":"/api-reference/campaigns/create-a-campaign"},{"title":"Start campaign","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/campaigns/{id}/start","href":"/api-reference/campaigns/start-campaign"},{"title":"Pause campaign","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/campaigns/{id}/pause","href":"/api-reference/campaigns/pause-campaign"},{"title":"Resume campaign","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/campaigns/{id}/resume","href":"/api-reference/campaigns/resume-campaign"},{"title":"Send a test email","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/campaigns/{id}/test-email","href":"/api-reference/campaigns/send-a-test-email"},{"title":"List campaigns","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/campaigns","href":"/api-reference/campaigns/list-campaigns"},{"title":"Get a campaign","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/campaigns/{id}","href":"/api-reference/campaigns/get-a-campaign"},{"title":"Update a campaign","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/campaigns/{id}","href":"/api-reference/campaigns/update-a-campaign"},{"title":"Delete a campaign","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/campaigns/{id}","href":"/api-reference/campaigns/delete-a-campaign"},{"title":"Campaign send status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/campaigns/{id}/status","href":"/api-reference/campaigns/campaign-send-status"}]},{"group":"Subsequences","pages":[{"title":"Create a subsequence","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/campaigns/{id}/subsequences","href":"/api-reference/subsequences/create-a-subsequence"},{"title":"List subsequences of a campaign","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/campaigns/{id}/subsequences","href":"/api-reference/subsequences/list-subsequences-of-a-campaign"},{"title":"Get a subsequence","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/subsequences/{id}","href":"/api-reference/subsequences/get-a-subsequence"},{"title":"Update a subsequence","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/subsequences/{id}","href":"/api-reference/subsequences/update-a-subsequence"},{"title":"Delete a subsequence","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/subsequences/{id}","href":"/api-reference/subsequences/delete-a-subsequence"},{"title":"Turn a subsequence on","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subsequences/{id}/enable","href":"/api-reference/subsequences/turn-a-subsequence-on"},{"title":"Pause a subsequence","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subsequences/{id}/pause","href":"/api-reference/subsequences/pause-a-subsequence"},{"title":"Resume a subsequence","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subsequences/{id}/resume","href":"/api-reference/subsequences/resume-a-subsequence"},{"title":"Move leads into a subsequence","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subsequences/{id}/leads","href":"/api-reference/subsequences/move-leads-into-a-subsequence"}]},{"group":"Emails","pages":[{"title":"List emails","description":"List emails across your mailboxes, newest first. Results carry a `snippet` preview but never the message body; fetch a single email to read it. Filter by mailbox, campaign, conversation, lead, read state, direction, folder, date, or full-text search.\n\nRequires one of the following scopes: `emails:read`, `emails:all`, `all:read`, `all:all`.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/emails","href":"/api-reference/emails/list-emails"},{"title":"Get an email","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/emails/{id}","href":"/api-reference/emails/get-an-email"},{"title":"Reply to an email","description":"Reply within the email's conversation. It is sent from the mailbox that owns the thread to the other party – you supply only the body (plus optional cc/bcc, which are blocklist-checked).\n\nRequires one of the following scopes: `emails:send`, `emails:all`, `all:all`.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/emails/{id}/reply","href":"/api-reference/emails/reply-to-an-email"},{"title":"Forward an email","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/emails/{id}/forward","href":"/api-reference/emails/forward-an-email"},{"title":"Count unread emails","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/emails/unread/count","href":"/api-reference/emails/count-unread-emails"},{"title":"Mark a conversation read","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/threads/{id}/read","href":"/api-reference/emails/mark-a-conversation-read"}]},{"group":"Leads","pages":[{"title":"Add leads","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/campaigns/{cid}/leads","href":"/api-reference/leads/add-leads"},{"title":"List campaign leads","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/campaigns/{cid}/leads","href":"/api-reference/leads/list-campaign-leads"},{"title":"Get a lead","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/campaigns/{cid}/leads/{leadId}","href":"/api-reference/leads/get-a-lead"},{"title":"Update a lead","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/campaigns/{cid}/leads/{leadId}","href":"/api-reference/leads/update-a-lead"},{"title":"Delete a lead","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/campaigns/{cid}/leads/{leadId}","href":"/api-reference/leads/delete-a-lead"},{"title":"Bulk mutate leads","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/campaigns/{cid}/leads/mutate","href":"/api-reference/leads/bulk-mutate-leads"},{"title":"Search leads by email","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/leads/search","href":"/api-reference/leads/search-leads-by-email"}]},{"group":"API Keys","pages":[{"title":"Create an API key","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/api-keys","href":"/api-reference/api-keys/create-an-api-key"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/api-keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Delete an API key","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/api-keys/{id}","href":"/api-reference/api-keys/delete-an-api-key"}]},{"group":"Workspace","pages":[{"title":"Current usage","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/usage","href":"/api-reference/workspace/current-usage"},{"title":"Current usage for one limit","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/usage/{limitType}","href":"/api-reference/workspace/current-usage-for-one-limit"},{"title":"Subscription","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/account/subscription","href":"/api-reference/workspace/subscription"},{"title":"Workspace identity","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/workspace","href":"/api-reference/workspace/workspace-identity"}]},{"group":"Analytics","pages":[{"title":"Campaign analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/campaigns/{id}/analytics","href":"/api-reference/analytics/campaign-analytics"},{"title":"Campaign analytics over time","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/campaigns/{id}/analytics/timeseries","href":"/api-reference/analytics/campaign-analytics-over-time"},{"title":"Workspace analytics roll-up","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/campaigns/analytics/overview","href":"/api-reference/analytics/workspace-analytics-roll-up"}]}]}]},"basePath":"","title":"Get an email - MailBeast API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}