Returns one message from the authenticated mailbox. Responses include a weak ETag header. When attachment metadata includes short-lived download URLs, a conditional request may return 200 even when the stable message ETag matches so the response can renew expired URLs.
Qubrics API key. Use a root API key for Management API routes, or a mailbox credential for Mailbox API routes. Obtain keys from the dashboard under API Keys.
Scopes
mailbox.read
Read mailbox contents (folders, messages)
Headers
If-None-Match
string
Weak ETag from a previous response. Returns 304 when unchanged.
Path Parameters
message_id
string
required
Message ID.
Query Parameters
mailbox_id
string
Mailbox public ID to target when the credential grants access to more than one mailbox. Omit when the credential is scoped to exactly one mailbox.
Response
Message
meta
object
required
Hide child attributes
meta.request_id
string
required
Example:
"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"
ok
enum<boolean>
required
Available options:
true
data
object
required
Hide child attributes
data.bcc
object[]
required
Hide child attributes
data.bcc.email
string<email>
required
Example:
"agent@example.com"
data.bcc.name
string | null
required
Example:
"Support"
data.cc
object[]
required
Hide child attributes
data.cc.email
string<email>
required
Example:
"agent@example.com"
data.cc.name
string | null
required
Example:
"Support"
data.flags
object
required
Hide child attributes
data.flags.answered
boolean
required
data.flags.draft
boolean
required
data.flags.flagged
boolean
required
data.flags.seen
boolean
required
data.folder_ids
string[]
required
data.from
object | null
required
Hide child attributes
data.from.email
string<email>
required
Example:
"agent@example.com"
data.from.name
string | null
required
Example:
"Support"
data.has_attachments
boolean
required
data.html_body
string | null
required
data.id
string
required
Message ID
data.in_reply_to
string[]
required
In-Reply-To header values, with the surrounding angle brackets removed — the message this one replies to. Empty when the message is not a reply.
Example:
["20260918.0009@example.com"]
data.keywords
string[]
required
Active message keywords, including system flags and custom labels.
Example:
["$seen", "$flagged", "agent_triaged"]
data.message_id
string[]
required
Message-ID header values for this message, with the surrounding angle brackets removed. Empty when the message carries no Message-ID.
Example:
["20260919.0001@example.com"]
data.preview
string | null
required
data.received_at
string | null
required
data.references
string[]
required
References header values, with the surrounding angle brackets removed — the ancestor chain of this message, oldest first. Empty when the message starts a conversation.
Reply-To addresses. Address replies here rather than to from whenever this is non-empty. Empty when the message carries no Reply-To.
Hide child attributes
data.reply_to.email
string<email>
required
Example:
"agent@example.com"
data.reply_to.name
string | null
required
Example:
"Support"
data.sent_at
string | null
required
data.size_bytes
integer | null
required
data.subject
string | null
required
data.text_body
string | null
required
data.thread_id
string | null
required
data.to
object[]
required
Hide child attributes
data.to.email
string<email>
required
Example:
"agent@example.com"
data.to.name
string | null
required
Example:
"Support"
data.attachments
object[]
Attachment metadata for this message. Each item includes a short-lived download_url; if it expires, fetch message metadata again.
Hide child attributes
data.attachments.content_id
string | null
required
Content ID for inline attachments, when present.
data.attachments.content_type
string
required
Example:
"application/pdf"
data.attachments.disposition
string | null
required
Example:
"attachment"
data.attachments.filename
string | null
required
Example:
"invoice.pdf"
data.attachments.id
string
required
Attachment blob ID.
data.attachments.size_bytes
integer | null
required
Example:
12345
data.attachments.download_url
string
Short-lived URL for this exact attachment. Fetch it promptly; if it expires, call the message or attachment metadata endpoint again to receive a fresh URL.
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Qubrics","description":"The intelligent email layer","colors":{"primary":"#6a75f1","light":"#5a84e9","dark":"#004aad"},"logo":{"light":"https://mintcdn.com/sendmux/9EML6-L2IAWgIXVX/images/logo-light.svg?fit=max\u0026auto=format\u0026n=9EML6-L2IAWgIXVX\u0026q=85\u0026s=0d301b6a4a28e21cf585335973584967","dark":"https://mintcdn.com/sendmux/9EML6-L2IAWgIXVX/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=9EML6-L2IAWgIXVX\u0026q=85\u0026s=612f5f9e57f97fd13812a619d185a2f9","href":"https://qubrics.com/docs"},"favicon":"https://mintcdn.com/sendmux/neuAiuAvPYRu89eG/images/favicon.svg?fit=max\u0026auto=format\u0026n=neuAiuAvPYRu89eG\u0026q=85\u0026s=557baee52eeabff3955db74427754525","api":{"params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript","go"],"autogenerate":true}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"/changelog","label":"Changelog"},{"href":"mailto:contact@qubrics.com","label":"Support"}],"primary":{"type":"button","label":"App","href":"https://app.qubrics.com"}},"footer":{"socials":{"x":"https://x.com/sendmux","github":"https://github.com/qubrics"}},"seo":{"metatags":{"canonical":"https://qubrics.com/docs"}},"fonts":{"family":"Lato","weight":400},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"App","href":"https://app.qubrics.com"},{"anchor":"Website","href":"https://qubrics.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sendmux","hasAudioNarration":false,"actualSubdomain":"sendmux","customDomains":["qubrics.com"],"gitSource":{"type":"github","owner":"qubrics","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{},"buildId":"6b002092cf93c63408f0644f","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Guides","count":79},{"language":"default","tag":"Management API","count":58},{"language":"default","tag":"Mailbox API","count":55},{"language":"default","tag":"AI integrations","count":32},{"language":"default","tag":"MCP","count":23},{"language":"default","tag":"Client setup","count":23},{"language":"default","tag":"Developer tools","count":20},{"language":"default","tag":"Sending accounts","count":18},{"language":"default","tag":"Mailboxes","count":15},{"language":"default","tag":"Messages","count":14}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"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":true},"customCss":[{"filePath":"style.css","content":":root{font-size:103%}.antialiased{-webkit-font-smoothing:auto!important;-moz-osx-font-smoothing:auto!important}.h1,.h2,.h3,.h4,.h5,.h6,h1,h2,h3,h4,h5,h6,.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{letter-spacing:var(--tracking-tight)!important}body,.prose,.prose p,.prose li,.prose td,.prose th,.prose blockquote{letter-spacing:0.00625rem!important}.eyebrow.h-5{text-transform:uppercase;letter-spacing:0.063em!important}h3.sidebar-title,#sidebar-title{display:flex;align-items:center;height:1.75rem;color:oklch(0.345 0.006 264 / 60%);text-transform:uppercase;font-size:0.7rem;font-weight:400;letter-spacing:0.044rem!important}.dark h3.sidebar-title,.dark #sidebar-title{color:oklch(0.985 0.001 106.423 / 60%)}"}]}
{"page":{"pagePath":"api/mailbox-api/get-a-mailbox-message","slug":"/api/mailbox-api/get-a-mailbox-message","pageMetadata":{"title":"Get a mailbox message","description":"Returns one message from the authenticated mailbox. Responses include a weak `ETag` header. When attachment metadata includes short-lived download URLs, a conditional request may return `200` even when the stable message ETag matches so the response can renew expired URLs.","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}","href":"/api/mailbox-api/get-a-mailbox-message","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {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(_components.p, {\n children: [\"Returns one message from the authenticated mailbox. Responses include a weak \", _jsx(_components.code, {\n children: \"ETag\"\n }), \" header. When attachment metadata includes short-lived download URLs, a conditional request may return \", _jsx(_components.code, {\n children: \"200\"\n }), \" even when the stable message ETag matches so the response can renew expired URLs.\"]\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 a mailbox message","description":"Returns one message from the authenticated mailbox. Responses include a weak `ETag` header. When attachment metadata includes short-lived download URLs, a conditional request may return `200` even when the stable message ETag matches so the response can renew expired URLs.","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}","href":"/api/mailbox-api/get-a-mailbox-message","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Returns one message from the authenticated mailbox. Responses include a weak `ETag` header. When attachment metadata includes short-lived download URLs, a conditional request may return `200` even when the stable message ETag matches so the response can renew expired URLs.","operationId":"mailboxGetMessage","parameters":["39b23e7a-cde6-4fd4-bdcb-aa42a890242e","7eadd00d-5274-452c-b0bf-d31cf30629f4","d206d70a-e9f9-4508-8dfc-0b32027cf985"],"responses":{"200":"f36c7db2-9cfd-4280-b59a-d4176ba806f9","304":"c9942188-0d7e-4277-9b37-1d4c6cd2ac14","404":"4a83a890-c117-4731-9cd6-a4797daa0d74"},"security":["8cb0dfe1-349a-4cc2-827b-df4e4b3c22a8","58e1b46e-7806-4da9-8de6-06b4c657eecc"],"summary":"Get a mailbox message","tags":["Mailbox API"],"method":"get","type":"path","servers":["47cfcb91-0c9c-47bb-8bd6-fe2f163124de"],"path":"/mailbox/messages/{message_id}","baseUrlOptions":["https://app.qubrics.com/api/v1"],"title":"Get a mailbox message","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"39b23e7a-cde6-4fd4-bdcb-aa42a890242e":{"in":"path","name":"message_id","required":true,"schema":{"description":"Message ID.","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"7eadd00d-5274-452c-b0bf-d31cf30629f4":{"in":"header","name":"If-None-Match","required":false,"schema":{"description":"Weak ETag from a previous response. Returns 304 when unchanged.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"d206d70a-e9f9-4508-8dfc-0b32027cf985":{"description":"Mailbox public ID to target when the credential grants access to more than one mailbox. Omit when the credential is scoped to exactly one mailbox.","in":"query","name":"mailbox_id","required":false,"schema":{"type":"string","isRequired":false,"description":"Mailbox public ID to target when the credential grants access to more than one mailbox. Omit when the credential is scoped to exactly one mailbox.","uniqueKey":"","typeLabel":"string"}}},"responses":{"f36c7db2-9cfd-4280-b59a-d4176ba806f9":{"content":{"application/json":{"schema":{"type":"object","required":["data","ok","meta"],"properties":{"meta":{"type":"object","required":["request_id"],"properties":{"request_id":{"example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[true],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"data":{"additionalProperties":false,"properties":{"bcc":{"items":{"additionalProperties":false,"properties":{"email":{"example":"agent@example.com","format":"email","type":"string","isRequired":true,"uniqueKey":"data.bcc.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"oneOf":[{"example":"Support","type":"string","isRequired":true,"uniqueKey":"data.bcc.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"example":"Support","type":"null","isRequired":true,"uniqueKey":"data.bcc.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.bcc.items.[INDEX].name","typeLabel":"string | null"}},"required":["email","name"],"type":"object","uniqueKey":"data.bcc.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data.bcc","typeLabel":"object[]"},"cc":{"items":{"additionalProperties":false,"properties":{"email":{"example":"agent@example.com","format":"email","type":"string","isRequired":true,"uniqueKey":"data.cc.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"oneOf":[{"example":"Support","type":"string","isRequired":true,"uniqueKey":"data.cc.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"example":"Support","type":"null","isRequired":true,"uniqueKey":"data.cc.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.cc.items.[INDEX].name","typeLabel":"string | null"}},"required":["email","name"],"type":"object","uniqueKey":"data.cc.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data.cc","typeLabel":"object[]"},"flags":{"additionalProperties":false,"properties":{"answered":{"type":"boolean","isRequired":true,"uniqueKey":"data.flags.answered","typeLabel":"boolean"},"draft":{"type":"boolean","isRequired":true,"uniqueKey":"data.flags.draft","typeLabel":"boolean"},"flagged":{"type":"boolean","isRequired":true,"uniqueKey":"data.flags.flagged","typeLabel":"boolean"},"seen":{"type":"boolean","isRequired":true,"uniqueKey":"data.flags.seen","typeLabel":"boolean"}},"required":["seen","flagged","draft","answered"],"type":"object","isRequired":true,"uniqueKey":"data.flags","typeLabel":"object"},"folder_ids":{"items":{"type":"string","uniqueKey":"data.folder_ids.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"data.folder_ids","typeLabel":"string[]"},"from":{"oneOf":[{"type":"object","required":["email","name"],"properties":{"email":{"example":"agent@example.com","format":"email","type":"string","isRequired":true,"uniqueKey":"data.from.oneOf.0.email","typeLabel":"string\u003cemail>"},"name":{"oneOf":[{"example":"Support","type":"string","isRequired":true,"uniqueKey":"data.from.oneOf.0.name.oneOf.0","typeLabel":"string"},{"example":"Support","type":"null","isRequired":true,"uniqueKey":"data.from.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.from.oneOf.0.name","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.from.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"data.from.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.from","typeLabel":"object | null"},"has_attachments":{"type":"boolean","isRequired":true,"uniqueKey":"data.has_attachments","typeLabel":"boolean"},"html_body":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.html_body.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.html_body.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.html_body","typeLabel":"string | null"},"id":{"description":"Message ID","type":"string","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"in_reply_to":{"description":"`In-Reply-To` header values, with the surrounding angle brackets removed — the message this one replies to. Empty when the message is not a reply.","example":["20260918.0009@example.com"],"items":{"type":"string","uniqueKey":"data.in_reply_to.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"data.in_reply_to","typeLabel":"string[]"},"keywords":{"description":"Active message keywords, including system flags and custom labels.","example":["$seen","$flagged","agent_triaged"],"items":{"type":"string","uniqueKey":"data.keywords.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"data.keywords","typeLabel":"string[]"},"message_id":{"description":"`Message-ID` header values for this message, with the surrounding angle brackets removed. Empty when the message carries no `Message-ID`.","example":["20260919.0001@example.com"],"items":{"type":"string","uniqueKey":"data.message_id.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"data.message_id","typeLabel":"string[]"},"preview":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.preview.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.preview.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.preview","typeLabel":"string | null"},"received_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.received_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.received_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.received_at","typeLabel":"string | null"},"references":{"description":"`References` header values, with the surrounding angle brackets removed — the ancestor chain of this message, oldest first. Empty when the message starts a conversation.","example":["20260917.0001@example.com","20260918.0009@example.com"],"items":{"type":"string","uniqueKey":"data.references.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"data.references","typeLabel":"string[]"},"reply_to":{"description":"`Reply-To` addresses. Address replies here rather than to `from` whenever this is non-empty. Empty when the message carries no `Reply-To`.","items":{"additionalProperties":false,"properties":{"email":{"example":"agent@example.com","format":"email","type":"string","isRequired":true,"uniqueKey":"data.reply_to.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"oneOf":[{"example":"Support","type":"string","isRequired":true,"uniqueKey":"data.reply_to.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"example":"Support","type":"null","isRequired":true,"uniqueKey":"data.reply_to.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.reply_to.items.[INDEX].name","typeLabel":"string | null"}},"required":["email","name"],"type":"object","uniqueKey":"data.reply_to.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data.reply_to","typeLabel":"object[]"},"sent_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.sent_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.sent_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.sent_at","typeLabel":"string | null"},"size_bytes":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.size_bytes.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.size_bytes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.size_bytes","typeLabel":"integer | null"},"subject":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.subject.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.subject.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.subject","typeLabel":"string | null"},"text_body":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.text_body.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.text_body.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.text_body","typeLabel":"string | null"},"thread_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.thread_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.thread_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.thread_id","typeLabel":"string | null"},"to":{"items":{"additionalProperties":false,"properties":{"email":{"example":"agent@example.com","format":"email","type":"string","isRequired":true,"uniqueKey":"data.to.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"oneOf":[{"example":"Support","type":"string","isRequired":true,"uniqueKey":"data.to.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"example":"Support","type":"null","isRequired":true,"uniqueKey":"data.to.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.to.items.[INDEX].name","typeLabel":"string | null"}},"required":["email","name"],"type":"object","uniqueKey":"data.to.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data.to","typeLabel":"object[]"},"attachments":{"description":"Attachment metadata for this message. Each item includes a short-lived `download_url`; if it expires, fetch message metadata again.","items":{"additionalProperties":false,"properties":{"content_id":{"oneOf":[{"description":"Content ID for inline attachments, when present.","type":"string","isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].content_id.oneOf.0","typeLabel":"string"},{"description":"Content ID for inline attachments, when present.","type":"null","isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].content_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].content_id","typeLabel":"string | null"},"content_type":{"example":"application/pdf","type":"string","isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].content_type","typeLabel":"string"},"disposition":{"oneOf":[{"example":"attachment","type":"string","isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].disposition.oneOf.0","typeLabel":"string"},{"example":"attachment","type":"null","isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].disposition.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].disposition","typeLabel":"string | null"},"filename":{"oneOf":[{"example":"invoice.pdf","type":"string","isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].filename.oneOf.0","typeLabel":"string"},{"example":"invoice.pdf","type":"null","isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].filename.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].filename","typeLabel":"string | null"},"id":{"description":"Attachment blob ID.","type":"string","isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].id","typeLabel":"string"},"size_bytes":{"oneOf":[{"example":12345,"type":"integer","isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].size_bytes.oneOf.0","typeLabel":"integer"},{"example":12345,"type":"null","isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].size_bytes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.attachments.items.[INDEX].size_bytes","typeLabel":"integer | null"},"download_url":{"description":"Short-lived URL for this exact attachment. Fetch it promptly; if it expires, call the message or attachment metadata endpoint again to receive a fresh URL.","example":"https://app.qubrics.com/api/v1/mailbox/messages/msg_123/attachment-downloads/attref_abc123?download_token=...","type":"string","uniqueKey":"data.attachments.items.[INDEX].download_url","typeLabel":"string"}},"required":["id","filename","content_type","size_bytes","disposition","content_id"],"type":"object","uniqueKey":"data.attachments.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"data.attachments","typeLabel":"object[]"}},"required":["id","thread_id","folder_ids","subject","preview","from","to","cc","bcc","received_at","sent_at","size_bytes","has_attachments","keywords","flags","text_body","html_body","message_id","in_reply_to","references","reply_to"],"type":"object","isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":true,"data":{"bcc":[{"email":"agent@example.com","name":"Support"}],"cc":[{"email":"agent@example.com","name":"Support"}],"flags":{"answered":true,"draft":true,"flagged":true,"seen":true},"folder_ids":["\u003cstring>"],"from":{"email":"agent@example.com","name":"Support"},"has_attachments":true,"html_body":"\u003cstring>","id":"\u003cstring>","in_reply_to":["20260918.0009@example.com"],"keywords":["$seen","$flagged","agent_triaged"],"message_id":["20260919.0001@example.com"],"preview":"\u003cstring>","received_at":"\u003cstring>","references":["20260917.0001@example.com","20260918.0009@example.com"],"reply_to":[{"email":"agent@example.com","name":"Support"}],"sent_at":"\u003cstring>","size_bytes":123,"subject":"\u003cstring>","text_body":"\u003cstring>","thread_id":"\u003cstring>","to":[{"email":"agent@example.com","name":"Support"}],"attachments":[{"content_id":"\u003cstring>","content_type":"application/pdf","disposition":"attachment","filename":"invoice.pdf","id":"\u003cstring>","size_bytes":12345,"download_url":"https://app.qubrics.com/api/v1/mailbox/messages/msg_123/attachment-downloads/attref_abc123?download_token=..."}]}}}},"exampleType":"generated"}},"description":"Message","exampleType":"generated"},"c9942188-0d7e-4277-9b37-1d4c6cd2ac14":{"description":"Not modified","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"4a83a890-c117-4731-9cd6-a4797daa0d74":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable error code","enum":["invalid_parameter","missing_parameter","authentication_required","insufficient_permissions","not_found","conflict","limit_exceeded","idempotency_conflict","payload_too_large","validation_error","rate_limit_exceeded","service_unavailable","internal_error"],"example":"invalid_parameter","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error description","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"description":"Whether the caller may safely retry this request. 4xx are typically false (except 429); 5xx are typically true.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"doc_url":{"description":"Link to relevant documentation","type":"string","uniqueKey":"error.doc_url","typeLabel":"string"},"errors":{"description":"Accumulated per-field issues for validation errors. Only present on 400/422 responses.","items":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable issue code from the validator (e.g. zod issue code).","example":"invalid_string","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"field":{"description":"Dot-path of the offending request field.","example":"recipient.email","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].field","typeLabel":"string"},"message":{"description":"Human-readable issue description.","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"type":"object","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.errors","typeLabel":"object[]"},"param":{"description":"The parameter that caused the error","type":"string","uniqueKey":"error.param","typeLabel":"string"}},"required":["code","message","retryable"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"additionalProperties":false,"properties":{"request_id":{"example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"}},"required":["ok","error","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_parameter","message":"\u003cstring>","retryable":false,"doc_url":"\u003cstring>","errors":[{"code":"invalid_string","field":"recipient.email","message":"\u003cstring>"}],"param":"\u003cstring>"},"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":false}}},"exampleType":"generated"}},"description":"Message not found","exampleType":"generated"}},"security":{"8cb0dfe1-349a-4cc2-827b-df4e4b3c22a8":{"bearerAuth":{"bearerFormat":"API Key","description":"Qubrics API key. Use a root API key for Management API routes, or a mailbox credential for Mailbox API routes. Obtain keys from the dashboard under API Keys.","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}},"58e1b46e-7806-4da9-8de6-06b4c657eecc":{"oauth2":{"description":"Use the authorisation-code flow with S256 PKCE and resource=https://qubrics.com/api. The user selects the team, API access and mailboxes during consent. OAuth access tokens authenticate HTTP API requests; use separate credentials for SMTP and IMAP.","flows":{"authorizationCode":{"authorizationUrl":"https://app.qubrics.com/oauth/authorize","refreshUrl":"https://app.qubrics.com/oauth/token","scopes":{"analytics.*":"All analytics operations","analytics.read":"View key usage analytics and verification logs","billing.*":"All billing operations","billing.auto_topup":"Configure auto top-up settings","billing.read":"View balance, transactions, invoices","billing.topup":"Purchase balance top-ups","calendar.read":"Read calendars and events in this mailbox","calendar.write":"Create calendars and create, edit and delete events in this mailbox","domain.*":"All domain operations","domain.create":"Add sending domains","domain.delete":"Remove domains","domain.read":"List/view domains and DNS status","domain.verify":"Trigger domain verification","email.receive":"Authorise email reception","email.send":"Send email through the HTTP API","key.*":"All key management operations","key.create":"Create new API keys (both root and mailbox)","key.read":"List/view API keys and their metadata","key.revoke":"Revoke API keys","key.rotate":"Rotate API keys","logs.*":"All log operations","logs.read":"View delivery logs","mailbox.admin.*":"All mailbox admin operations","mailbox.admin.create":"Create mailboxes (admin-level)","mailbox.admin.delete":"Delete mailboxes (admin-level)","mailbox.admin.manage":"Manage all mailbox settings","mailbox.admin.read":"List/view mailboxes (admin-level)","mailbox.drafts.write":"Create and edit saved mailbox drafts","mailbox.read":"Read mailbox contents (folders, messages)","mailbox.settings.update":"Update own mailbox settings (signature, auto-reply)","provider.*":"All provider operations","provider.create":"Add email provider accounts (Google, Microsoft, SMTP)","provider.delete":"Remove provider accounts","provider.read":"List/view provider accounts and connection status","provider.update":"Update provider settings, refresh tokens","routing.*":"All routing operations","routing.create":"Create delivery groups","routing.delete":"Remove delivery groups","routing.read":"List/view delivery groups and routing rules","routing.update":"Update delivery group configuration","team.*":"All team operations","team.members.invite":"Invite team members","team.members.remove":"Remove team members","team.members.roles":"Change member roles","team.read":"View team settings and members","team.update":"Update team settings","webhook.*":"All webhook operations","webhook.create":"Create webhook subscriptions","webhook.delete":"Delete webhook subscriptions","webhook.manage":"Rotate signing secret + send test events","webhook.read":"List/view webhook subscriptions","webhook.update":"Update webhook URL, event types, enabled flag"},"tokenUrl":"https://app.qubrics.com/oauth/token"}},"type":"oauth2","scopes":["mailbox.read"],"schemeName":"oauth2"}}},"servers":{"47cfcb91-0c9c-47bb-8bd6-fe2f163124de":{"description":"API v1","url":"https://app.qubrics.com/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"API Key","description":"Qubrics API key. Use a root API key for Management API routes, or a mailbox credential for Mailbox API routes. Obtain keys from the dashboard under API Keys.","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Qubrics API key. Use a root API key for Management API routes, or a mailbox credential for Mailbox API routes. Obtain keys from the dashboard under API Keys.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"description":"Use the authorisation-code flow with S256 PKCE and resource=https://qubrics.com/api. The user selects the team, API access and mailboxes during consent. OAuth access tokens authenticate HTTP API requests; use separate credentials for SMTP and IMAP.","flows":{"authorizationCode":{"authorizationUrl":"https://app.qubrics.com/oauth/authorize","refreshUrl":"https://app.qubrics.com/oauth/token","scopes":{"analytics.*":"All analytics operations","analytics.read":"View key usage analytics and verification logs","billing.*":"All billing operations","billing.auto_topup":"Configure auto top-up settings","billing.read":"View balance, transactions, invoices","billing.topup":"Purchase balance top-ups","calendar.read":"Read calendars and events in this mailbox","calendar.write":"Create calendars and create, edit and delete events in this mailbox","domain.*":"All domain operations","domain.create":"Add sending domains","domain.delete":"Remove domains","domain.read":"List/view domains and DNS status","domain.verify":"Trigger domain verification","email.receive":"Authorise email reception","email.send":"Send email through the HTTP API","key.*":"All key management operations","key.create":"Create new API keys (both root and mailbox)","key.read":"List/view API keys and their metadata","key.revoke":"Revoke API keys","key.rotate":"Rotate API keys","logs.*":"All log operations","logs.read":"View delivery logs","mailbox.admin.*":"All mailbox admin operations","mailbox.admin.create":"Create mailboxes (admin-level)","mailbox.admin.delete":"Delete mailboxes (admin-level)","mailbox.admin.manage":"Manage all mailbox settings","mailbox.admin.read":"List/view mailboxes (admin-level)","mailbox.drafts.write":"Create and edit saved mailbox drafts","mailbox.read":"Read mailbox contents (folders, messages)","mailbox.settings.update":"Update own mailbox settings (signature, auto-reply)","provider.*":"All provider operations","provider.create":"Add email provider accounts (Google, Microsoft, SMTP)","provider.delete":"Remove provider accounts","provider.read":"List/view provider accounts and connection status","provider.update":"Update provider settings, refresh tokens","routing.*":"All routing operations","routing.create":"Create delivery groups","routing.delete":"Remove delivery groups","routing.read":"List/view delivery groups and routing rules","routing.update":"Update delivery group configuration","team.*":"All team operations","team.members.invite":"Invite team members","team.members.remove":"Remove team members","team.members.roles":"Change member roles","team.read":"View team settings and members","team.update":"Update team settings","webhook.*":"All webhook operations","webhook.create":"Create webhook subscriptions","webhook.delete":"Delete webhook subscriptions","webhook.manage":"Rotate signing secret + send test events","webhook.read":"List/view webhook subscriptions","webhook.update":"Update webhook URL, event types, enabled flag"},"tokenUrl":"https://app.qubrics.com/oauth/token"}},"type":"oauth2","scopes":["mailbox.read"],"schemeName":"oauth2"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"Use the authorisation-code flow with S256 PKCE and resource=https://qubrics.com/api. The user selects the team, API access and mailboxes during consent. OAuth access tokens authenticate HTTP API requests; use separate credentials for SMTP and IMAP.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"oauth2","name":"Authorization"}],"title":"oauth2"}]},"originalFileLocation":"openapi-app.json"},"subdomain":"sendmux","siteName":"Qubrics","title":"Get a mailbox message - Qubrics","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T05:44:28.538Z","originalFileLocation":"api/mailbox-api/get-a-mailbox-message.mdx"},"headHtml":"\u003cscript data-mint-head\u003e(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\u003e\u003cmeta data-mint-head name=\"description\" content=\"Returns one message from the authenticated mailbox. Responses include a weak ETag header. When attachment metadata includes short-lived download URLs, a conditional request may return 200 even when the stable message ETag matches so the response can renew expired URLs.\"\u003e\u003cmeta data-mint-head name=\"application-name\" content=\"Qubrics\"\u003e\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\"\u003e\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\"\u003e\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon/apple-touch-icon.png\"\u003e\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\"\u003e\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\"\u003e\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\"\u003e\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\"\u003e\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\"\u003e\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\"\u003e\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\"\u003e\u003cmeta data-mint-head property=\"og:title\" content=\"Get a mailbox message - Qubrics\"\u003e\u003cmeta data-mint-head property=\"og:description\" content=\"Returns one message from the authenticated mailbox. Responses include a weak ETag header. When attachment metadata includes short-lived download URLs, a conditional request may return 200 even when the stable message ETag matches so the response can renew expired URLs.\"\u003e\u003cmeta data-mint-head property=\"og:site_name\" content=\"Qubrics\"\u003e\u003cmeta data-mint-head property=\"og:url\" content=\"https://qubrics.com/docs/api/mailbox-api/get-a-mailbox-message\"\u003e\u003cmeta data-mint-head property=\"og:type\" content=\"website\"\u003e\u003cmeta data-mint-head property=\"og:image\" content=\"https://qubrics.com/docs/_mintlify/api/og/v2?division=Messages\u0026amp;title=Get+a+mailbox+message\u0026amp;description=Returns+one+message+from+the+authenticated+mailbox.+Responses+include+a+weak+%60ETag%60+header.+When+attachment+metadata+includes+short-lived+download+URLs%2C+a+condi\u0026amp;theme=8d3480837e3238732b09c327\u0026amp;signature=2723130a9d1b931a507dff0d340e85a33879fc759ddfc44081a038a79d12ccf3\"\u003e\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\"\u003e\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\"\u003e\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\"\u003e\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a mailbox message - Qubrics\"\u003e\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns one message from the authenticated mailbox. Responses include a weak ETag header. When attachment metadata includes short-lived download URLs, a conditional request may return 200 even when the stable message ETag matches so the response can renew expired URLs.\"\u003e\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://qubrics.com/docs/_mintlify/api/og/v2?division=Messages\u0026amp;title=Get+a+mailbox+message\u0026amp;description=Returns+one+message+from+the+authenticated+mailbox.+Responses+include+a+weak+%60ETag%60+header.+When+attachment+metadata+includes+short-lived+download+URLs%2C+a+condi\u0026amp;theme=8d3480837e3238732b09c327\u0026amp;signature=2723130a9d1b931a507dff0d340e85a33879fc759ddfc44081a038a79d12ccf3\"\u003e\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\"\u003e\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\"\u003e\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/sendmux/QBifi-yrmD9atxWJ/_generated/favicon/browserconfig.xml\"\u003e\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Qubrics\"\u003e\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6a75f1\"\u003e\u003clink data-mint-head rel=\"canonical\" href=\"https://qubrics.com/docs/api/mailbox-api/get-a-mailbox-message\"\u003e\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\"\u003e\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api/mailbox-api/get-a-mailbox-message.md\"\u003e\u003cscript data-mint-head type=\"application/ld+json\"\u003e{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://qubrics.com/#organization\",\"name\":\"Qubrics\",\"url\":\"https://qubrics.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sendmux/9EML6-L2IAWgIXVX/images/logo-light.svg?fit=max\u0026auto=format\u0026n=9EML6-L2IAWgIXVX\u0026q=85\u0026s=0d301b6a4a28e21cf585335973584967\"}},{\"@type\":\"WebSite\",\"@id\":\"https://qubrics.com/docs#website\",\"name\":\"Qubrics\",\"url\":\"https://qubrics.com/docs\",\"publisher\":{\"@id\":\"https://qubrics.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://qubrics.com/docs/api/mailbox-api/get-a-mailbox-message#webpage\",\"url\":\"https://qubrics.com/docs/api/mailbox-api/get-a-mailbox-message\",\"name\":\"Get a mailbox message\",\"description\":\"Returns one message from the authenticated mailbox. Responses include a weak ETag header. When attachment metadata includes short-lived download URLs, a conditional request may return 200 even when the stable message ETag matches so the response can renew expired URLs.\",\"dateModified\":\"2026-11-19T05:44:28.538Z\",\"isPartOf\":{\"@id\":\"https://qubrics.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://qubrics.com/docs/api/mailbox-api/get-a-mailbox-message#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://qubrics.com/docs/api/mailbox-api/get-a-mailbox-message#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Messages\",\"item\":\"https://qubrics.com/docs/api/mailbox-api/list-mailbox-messages\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a mailbox message\",\"item\":\"https://qubrics.com/docs/api/mailbox-api/get-a-mailbox-message\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://qubrics.com/docs/api/mailbox-api/get-a-mailbox-message#apireference\",\"headline\":\"Get a mailbox message\",\"name\":\"Get a mailbox message\",\"description\":\"Returns one message from the authenticated mailbox. Responses include a weak ETag header. When attachment metadata includes short-lived download URLs, a conditional request may return 200 even when the stable message ETag matches so the response can renew expired URLs.\",\"url\":\"https://qubrics.com/docs/api/mailbox-api/get-a-mailbox-message\",\"mainEntityOfPage\":{\"@id\":\"https://qubrics.com/docs/api/mailbox-api/get-a-mailbox-message#webpage\"},\"dateModified\":\"2026-11-19T05:44:28.538Z\",\"publisher\":{\"@id\":\"https://qubrics.com/#organization\"},\"isPartOf\":{\"@id\":\"https://qubrics.com/docs#website\"}}]}\u003c/script\u003e\u003cscript data-mint-head type=\"application/ld+json\"\u003e{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Qubrics\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Qubrics\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script\u003e","agentPointerHref":"/docs/api/mailbox-api/get-a-mailbox-message.md","siteName":"Qubrics","nav":{"global":{"anchors":[{"anchor":"App","href":"https://app.qubrics.com"},{"anchor":"Website","href":"https://qubrics.com"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"Management API","pages":[{"title":"Management API","href":"/api/introduction"}]},{"tab":"Mailbox API","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/mailbox-api/introduction"},{"title":"Errors","href":"/mailbox-api/errors"},{"title":"Get Mailbox connection","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/connection","href":"/api/mailbox-api/get-mailbox-connection"}]},{"group":"Mailboxes","pages":[{"title":"List granted mailboxes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/mailboxes","href":"/api/mailbox-api/list-granted-mailboxes"}]},{"group":"Session and identity","pages":[{"title":"Self-introspect the calling mailbox","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/me","href":"/api/mailbox-api/self-introspect-the-calling-mailbox"},{"title":"Get mailbox API session","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/session","href":"/api/mailbox-api/get-mailbox-api-session"},{"title":"Get permitted sender choices","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/sender-choices","href":"/api/mailbox-api/get-permitted-sender-choices"},{"title":"Get mailbox sender identity","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/identity","href":"/api/mailbox-api/get-mailbox-sender-identity"},{"title":"Update mailbox sender identity","deprecated":null,"version":null,"openapi":"/openapi-app.json patch /mailbox/identity","href":"/api/mailbox-api/update-mailbox-sender-identity"},{"title":"List mailbox sender identities","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/identities","href":"/api/mailbox-api/list-mailbox-sender-identities"}]},{"group":"Messages","pages":[{"title":"List mailbox messages","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages","href":"/api/mailbox-api/list-mailbox-messages"},{"title":"Batch get mailbox messages","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/messages:batch-get","href":"/api/mailbox-api/batch-get-mailbox-messages"},{"title":"Batch update mailbox messages","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/messages:batch-update","href":"/api/mailbox-api/batch-update-mailbox-messages"},{"title":"Batch delete mailbox messages","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/messages:batch-delete","href":"/api/mailbox-api/batch-delete-mailbox-messages"},{"title":"Count mailbox messages","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/count","href":"/api/mailbox-api/count-mailbox-messages"},{"title":"Get message query changes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/query-changes","href":"/api/mailbox-api/get-message-query-changes"},{"title":"Get message search snippets","description":"Returns subject and preview snippets for a text search. Provide `message_ids` to snippet exact messages, or omit it to snippet the first filtered results.","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/search-snippets","href":"/api/mailbox-api/get-message-search-snippets"},{"title":"Get a mailbox message","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}","href":"/api/mailbox-api/get-a-mailbox-message"},{"title":"Get raw message body","description":"Returns raw message body content for the authenticated mailbox. This endpoint does not strip signatures, strip quoted replies, extract links, or clean the body into a structured content shape.","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}/body","href":"/api/mailbox-api/get-raw-message-body"},{"title":"Get clean message content","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}/content","href":"/api/mailbox-api/get-clean-message-content"},{"title":"Download the original message","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}/raw","href":"/api/mailbox-api/download-the-original-message"},{"title":"Update mailbox message flags","deprecated":null,"version":null,"openapi":"/openapi-app.json patch /mailbox/messages/{message_id}","href":"/api/mailbox-api/update-mailbox-message-flags"},{"title":"Delete a mailbox message","deprecated":null,"version":null,"openapi":"/openapi-app.json delete /mailbox/messages/{message_id}","href":"/api/mailbox-api/delete-a-mailbox-message"},{"title":"Send a mailbox message","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/messages/send","href":"/api/mailbox-api/send-a-mailbox-message"}]},{"group":"Saved drafts","pages":[{"title":"List saved drafts","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/drafts","href":"/api/mailbox-api/list-saved-drafts"},{"title":"Create a saved draft","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/drafts","href":"/api/mailbox-api/create-a-saved-draft"},{"title":"Read a saved draft","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/drafts/{draftId}","href":"/api/mailbox-api/read-a-saved-draft"},{"title":"Edit a saved draft","deprecated":null,"version":null,"openapi":"/openapi-app.json patch /mailbox/drafts/{draftId}","href":"/api/mailbox-api/edit-a-saved-draft"},{"title":"Delete a saved draft","deprecated":null,"version":null,"openapi":"/openapi-app.json delete /mailbox/drafts/{draftId}","href":"/api/mailbox-api/delete-a-saved-draft"},{"title":"Send a saved draft revision","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/drafts/{draftId}/send","href":"/api/mailbox-api/send-a-saved-draft-revision"},{"title":"Reschedule or cancel a saved draft send","deprecated":null,"version":null,"openapi":"/openapi-app.json patch /mailbox/drafts/{draftId}/schedule","href":"/api/mailbox-api/reschedule-or-cancel-a-saved-draft-send"}]},{"group":"Attachments","pages":[{"title":"Upload a mailbox attachment","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/attachments:upload","href":"/api/mailbox-api/upload-a-mailbox-attachment"},{"title":"Create a presigned mailbox attachment upload","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/attachment-uploads","href":"/api/mailbox-api/create-a-presigned-mailbox-attachment-upload"},{"title":"Download a message attachment","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}/attachments/{attachment_id}","href":"/api/mailbox-api/download-a-message-attachment"},{"title":"Request attachment text","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/messages/{message_id}/attachments/{attachment_id}/text","href":"/api/mailbox-api/request-attachment-text"},{"title":"Read attachment text","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}/attachments/{attachment_id}/text","href":"/api/mailbox-api/read-attachment-text"}]},{"group":"Threads","pages":[{"title":"List mailbox threads","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/threads","href":"/api/mailbox-api/list-mailbox-threads"},{"title":"Get a mailbox thread","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/threads/{thread_id}","href":"/api/mailbox-api/get-a-mailbox-thread"},{"title":"List thread messages","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/threads/{thread_id}/messages","href":"/api/mailbox-api/list-thread-messages"},{"title":"Get clean thread content","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/threads/{thread_id}/content","href":"/api/mailbox-api/get-clean-thread-content"}]},{"group":"Folders","pages":[{"title":"List mailbox folders","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/folders","href":"/api/mailbox-api/list-mailbox-folders"},{"title":"Create a mailbox folder","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/folders","href":"/api/mailbox-api/create-a-mailbox-folder"},{"title":"Get folder changes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/folders/changes","href":"/api/mailbox-api/get-folder-changes"},{"title":"Get folder query changes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/folders/query-changes","href":"/api/mailbox-api/get-folder-query-changes"},{"title":"Get a mailbox folder","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/folders/{folder_id}","href":"/api/mailbox-api/get-a-mailbox-folder"},{"title":"Update a mailbox folder","deprecated":null,"version":null,"openapi":"/openapi-app.json patch /mailbox/folders/{folder_id}","href":"/api/mailbox-api/update-a-mailbox-folder"},{"title":"Delete a mailbox folder","deprecated":null,"version":null,"openapi":"/openapi-app.json delete /mailbox/folders/{folder_id}","href":"/api/mailbox-api/delete-a-mailbox-folder"}]},{"group":"Submissions","pages":[{"title":"List mailbox submissions","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/submissions","href":"/api/mailbox-api/list-mailbox-submissions"},{"title":"Get submission changes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/submissions/changes","href":"/api/mailbox-api/get-submission-changes"},{"title":"Get a mailbox submission","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/submissions/{submission_id}","href":"/api/mailbox-api/get-a-mailbox-submission"}]},{"group":"Usage","pages":[{"title":"List mailbox quotas","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/quotas","href":"/api/mailbox-api/list-mailbox-quotas"},{"title":"Get quota changes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/quotas/changes","href":"/api/mailbox-api/get-quota-changes"},{"title":"Get mailbox usage","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/usage","href":"/api/mailbox-api/get-mailbox-usage"}]},{"group":"Sync","pages":[{"title":"Get mailbox changes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/changes","href":"/api/mailbox-api/get-mailbox-changes"},{"title":"Stream mailbox events","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/events","href":"/api/mailbox-api/stream-mailbox-events"}]}]},{"tab":"Sending API","pages":[{"title":"Sending API","href":"/sending-api/introduction"}]}]},"basePath":"","title":"Get a mailbox message - Qubrics","deploymentId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","buildId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DyP0AOE1.js","snippetPresets-CuYPAUIG.js","utils-ez5j6NBT.js","style-to-object-BY3JEAdk.js","utils-DG4aeUOF.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DFhcMUrP.js","conditional-requirements-CFM0id0Q.js","cloneDeep-ByDTqllG.js","_Uint8Array-CJ2WjX_H.js","isObject-FP1Yky1u.js","Page-CInwEL5w.js","CodeSnippet-CCk6UVRR.js","DynamicMarkdown-CU5QIokU.js","SectionHeading-BoT1NwPU.js","icon-MsvNhD56.js","ApiExamples-fyn9sMD9.js","usePlaygroundInputsStore-Bf0N_Y6L.js","shallow-CnU26VTn.js","isEqual-OWIKZzop.js","CodeSnippets-CZ9-M31v.js","getApiPlaygroundDisplay-BUw5JwZB.js","MethodPill-CC7p0-fp.js","getPastedJson-BOWYR2ND.js","DuplicateIcon-DOWJyC1b.js","createIcon-BsNyCaLY.js","axios-CsQoIw0U.js","Markdown-L0uigQE0.js","AssistantPageLink-Cur5OU4v.js","dist-CLdzWocy.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}