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)
Path Parameters
thread_id
string
required
Thread ID.
Query Parameters
cursor
string
Pagination cursor — the next_cursor from the previous response.
limit
integer
Maximum results (default 50, max 100).
Required range: 1 <= x <= 100
sort
enum<string>
Message sort direction within the thread.
Available options:
asc,
desc
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
Thread messages
meta
object
required
Hide child attributes
meta.request_id
string
required
meta.thread_id
string
required
meta.sync_state
string
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.id
string
required
Message ID
data.keywords
string[]
required
Active message keywords, including system flags and custom labels.
Example:
["$seen", "$flagged", "agent_triaged"]
data.preview
string | null
required
data.received_at
string | null
required
data.sent_at
string | null
required
data.size_bytes
integer | null
required
data.subject
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/list-thread-messages","slug":"/api/mailbox-api/list-thread-messages","pageMetadata":{"title":"List thread messages","description":"Returns cursor-paginated message summaries for one thread. Use the thread content endpoint when you need cleaned bodies.","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/threads/{thread_id}/messages","href":"/api/mailbox-api/list-thread-messages","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns cursor-paginated message summaries for one thread. Use the thread content endpoint when you need cleaned bodies.\"\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":"List thread messages","description":"Returns cursor-paginated message summaries for one thread. Use the thread content endpoint when you need cleaned bodies.","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/threads/{thread_id}/messages","href":"/api/mailbox-api/list-thread-messages","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Returns cursor-paginated message summaries for one thread. Use the thread content endpoint when you need cleaned bodies.","operationId":"mailboxListThreadMessages","parameters":["6f63b5d5-5b2d-4f49-99b9-047e711f8936","8a995c48-9e89-438c-a6d3-6be1fc66c434","3667444e-e045-4e46-a5b1-fcc85918a839","a213d8e6-c18b-4e2f-8844-9d4a9c0a88d9","4750f531-199b-4136-ab74-41124f73aa91"],"responses":{"200":"31d8d1d8-f54b-49ad-b335-ffd3049d3bf1","400":"49900bc2-a068-46f6-9491-ca149a9ceb8e","404":"aa0bbb82-eeef-4bac-a9fd-8684fc051d63"},"security":["73f820f1-ae80-45d3-82a7-b473aaf64885","8d39ae03-d840-479d-94ae-009c6c26bdd6"],"summary":"List thread messages","tags":["Mailbox API"],"method":"get","type":"path","servers":["47cfcb91-0c9c-47bb-8bd6-fe2f163124de"],"path":"/mailbox/threads/{thread_id}/messages","baseUrlOptions":["https://app.qubrics.com/api/v1"],"title":"List thread messages","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6f63b5d5-5b2d-4f49-99b9-047e711f8936":{"in":"path","name":"thread_id","required":true,"schema":{"description":"Thread ID.","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"8a995c48-9e89-438c-a6d3-6be1fc66c434":{"in":"query","name":"cursor","required":false,"schema":{"description":"Pagination cursor — the `next_cursor` from the previous response.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"3667444e-e045-4e46-a5b1-fcc85918a839":{"in":"query","name":"limit","required":false,"schema":{"description":"Maximum results (default 50, max 100).","maximum":100,"minimum":1,"type":"integer","isRequired":false,"uniqueKey":"","typeLabel":"integer"}},"a213d8e6-c18b-4e2f-8844-9d4a9c0a88d9":{"in":"query","name":"sort","required":false,"schema":{"description":"Message sort direction within the thread.","enum":["asc","desc"],"type":"string","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"4750f531-199b-4136-ab74-41124f73aa91":{"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":{"31d8d1d8-f54b-49ad-b335-ffd3049d3bf1":{"content":{"application/json":{"schema":{"type":"object","required":["data","pagination","ok","meta"],"properties":{"meta":{"type":"object","required":["request_id","thread_id"],"properties":{"request_id":{"type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"thread_id":{"type":"string","isRequired":true,"uniqueKey":"meta.thread_id","typeLabel":"string"},"sync_state":{"type":"string","uniqueKey":"meta.sync_state","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[true],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"data":{"items":{"additionalProperties":false,"properties":{"bcc":{"items":{"additionalProperties":false,"properties":{"email":{"example":"agent@example.com","format":"email","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].bcc.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"oneOf":[{"example":"Support","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].bcc.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"example":"Support","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].bcc.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].bcc.items.[INDEX].name","typeLabel":"string | null"}},"required":["email","name"],"type":"object","uniqueKey":"data.items.[INDEX].bcc.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data.items.[INDEX].bcc","typeLabel":"object[]"},"cc":{"items":{"additionalProperties":false,"properties":{"email":{"example":"agent@example.com","format":"email","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].cc.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"oneOf":[{"example":"Support","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].cc.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"example":"Support","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].cc.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].cc.items.[INDEX].name","typeLabel":"string | null"}},"required":["email","name"],"type":"object","uniqueKey":"data.items.[INDEX].cc.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data.items.[INDEX].cc","typeLabel":"object[]"},"flags":{"additionalProperties":false,"properties":{"answered":{"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].flags.answered","typeLabel":"boolean"},"draft":{"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].flags.draft","typeLabel":"boolean"},"flagged":{"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].flags.flagged","typeLabel":"boolean"},"seen":{"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].flags.seen","typeLabel":"boolean"}},"required":["seen","flagged","draft","answered"],"type":"object","isRequired":true,"uniqueKey":"data.items.[INDEX].flags","typeLabel":"object"},"folder_ids":{"items":{"type":"string","uniqueKey":"data.items.[INDEX].folder_ids.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"data.items.[INDEX].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.items.[INDEX].from.oneOf.0.email","typeLabel":"string\u003cemail>"},"name":{"oneOf":[{"example":"Support","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].from.oneOf.0.name.oneOf.0","typeLabel":"string"},{"example":"Support","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].from.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].from.oneOf.0.name","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.items.[INDEX].from.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].from.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].from","typeLabel":"object | null"},"has_attachments":{"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].has_attachments","typeLabel":"boolean"},"id":{"description":"Message ID","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"keywords":{"description":"Active message keywords, including system flags and custom labels.","example":["$seen","$flagged","agent_triaged"],"items":{"type":"string","uniqueKey":"data.items.[INDEX].keywords.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"data.items.[INDEX].keywords","typeLabel":"string[]"},"preview":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].preview.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].preview.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].preview","typeLabel":"string | null"},"received_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].received_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].received_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].received_at","typeLabel":"string | null"},"sent_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].sent_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].sent_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].sent_at","typeLabel":"string | null"},"size_bytes":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].size_bytes.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].size_bytes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].size_bytes","typeLabel":"integer | null"},"subject":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].subject.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].subject.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].subject","typeLabel":"string | null"},"thread_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].thread_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].thread_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].thread_id","typeLabel":"string | null"},"to":{"items":{"additionalProperties":false,"properties":{"email":{"example":"agent@example.com","format":"email","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].to.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"oneOf":[{"example":"Support","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].to.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"example":"Support","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].to.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].to.items.[INDEX].name","typeLabel":"string | null"}},"required":["email","name"],"type":"object","uniqueKey":"data.items.[INDEX].to.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data.items.[INDEX].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.items.[INDEX].attachments.items.[INDEX].content_id.oneOf.0","typeLabel":"string"},{"description":"Content ID for inline attachments, when present.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].content_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].content_id","typeLabel":"string | null"},"content_type":{"example":"application/pdf","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].content_type","typeLabel":"string"},"disposition":{"oneOf":[{"example":"attachment","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].disposition.oneOf.0","typeLabel":"string"},{"example":"attachment","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].disposition.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].disposition","typeLabel":"string | null"},"filename":{"oneOf":[{"example":"invoice.pdf","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].filename.oneOf.0","typeLabel":"string"},{"example":"invoice.pdf","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].filename.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].filename","typeLabel":"string | null"},"id":{"description":"Attachment blob ID.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].id","typeLabel":"string"},"size_bytes":{"oneOf":[{"example":12345,"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].size_bytes.oneOf.0","typeLabel":"integer"},{"example":12345,"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].size_bytes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].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.items.[INDEX].attachments.items.[INDEX].download_url","typeLabel":"string"}},"required":["id","filename","content_type","size_bytes","disposition","content_id"],"type":"object","uniqueKey":"data.items.[INDEX].attachments.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"data.items.[INDEX].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"],"type":"object","uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"pagination":{"additionalProperties":false,"properties":{"has_more":{"type":"boolean","isRequired":true,"uniqueKey":"pagination.has_more","typeLabel":"boolean"},"next_cursor":{"type":"string","uniqueKey":"pagination.next_cursor","typeLabel":"string"}},"required":["has_more"],"type":"object","isRequired":true,"uniqueKey":"pagination","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"meta":{"request_id":"\u003cstring>","thread_id":"\u003cstring>","sync_state":"\u003cstring>"},"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,"id":"\u003cstring>","keywords":["$seen","$flagged","agent_triaged"],"preview":"\u003cstring>","received_at":"\u003cstring>","sent_at":"\u003cstring>","size_bytes":123,"subject":"\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=..."}]}],"pagination":{"has_more":true,"next_cursor":"\u003cstring>"}}}},"exampleType":"generated"}},"description":"Thread messages","exampleType":"generated"},"49900bc2-a068-46f6-9491-ca149a9ceb8e":{"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":"Invalid query parameter","exampleType":"generated"},"aa0bbb82-eeef-4bac-a9fd-8684fc051d63":{"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":"Thread not found","exampleType":"generated"}},"security":{"73f820f1-ae80-45d3-82a7-b473aaf64885":{"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"}},"8d39ae03-d840-479d-94ae-009c6c26bdd6":{"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":"List thread messages - Qubrics","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T05:44:28.870Z","originalFileLocation":"api/mailbox-api/list-thread-messages.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 cursor-paginated message summaries for one thread. Use the thread content endpoint when you need cleaned bodies.\"\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=\"List thread messages - Qubrics\"\u003e\u003cmeta data-mint-head property=\"og:description\" content=\"Returns cursor-paginated message summaries for one thread. Use the thread content endpoint when you need cleaned bodies.\"\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/list-thread-messages\"\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=Threads\u0026amp;title=List+thread+messages\u0026amp;description=Returns+cursor-paginated+message+summaries+for+one+thread.+Use+the+thread+content+endpoint+when+you+need+cleaned+bodies.\u0026amp;theme=8d3480837e3238732b09c327\u0026amp;signature=630983d12694aac54ec4f7ffd9bd87b77e0136e2b55f2f1f435643b0e9af9e54\"\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=\"List thread messages - Qubrics\"\u003e\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns cursor-paginated message summaries for one thread. Use the thread content endpoint when you need cleaned bodies.\"\u003e\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://qubrics.com/docs/_mintlify/api/og/v2?division=Threads\u0026amp;title=List+thread+messages\u0026amp;description=Returns+cursor-paginated+message+summaries+for+one+thread.+Use+the+thread+content+endpoint+when+you+need+cleaned+bodies.\u0026amp;theme=8d3480837e3238732b09c327\u0026amp;signature=630983d12694aac54ec4f7ffd9bd87b77e0136e2b55f2f1f435643b0e9af9e54\"\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/list-thread-messages\"\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/list-thread-messages.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/list-thread-messages#webpage\",\"url\":\"https://qubrics.com/docs/api/mailbox-api/list-thread-messages\",\"name\":\"List thread messages\",\"description\":\"Returns cursor-paginated message summaries for one thread. Use the thread content endpoint when you need cleaned bodies.\",\"dateModified\":\"2026-11-19T05:44:28.870Z\",\"isPartOf\":{\"@id\":\"https://qubrics.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://qubrics.com/docs/api/mailbox-api/list-thread-messages#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://qubrics.com/docs/api/mailbox-api/list-thread-messages#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Threads\",\"item\":\"https://qubrics.com/docs/api/mailbox-api/list-mailbox-threads\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List thread messages\",\"item\":\"https://qubrics.com/docs/api/mailbox-api/list-thread-messages\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://qubrics.com/docs/api/mailbox-api/list-thread-messages#apireference\",\"headline\":\"List thread messages\",\"name\":\"List thread messages\",\"description\":\"Returns cursor-paginated message summaries for one thread. Use the thread content endpoint when you need cleaned bodies.\",\"url\":\"https://qubrics.com/docs/api/mailbox-api/list-thread-messages\",\"mainEntityOfPage\":{\"@id\":\"https://qubrics.com/docs/api/mailbox-api/list-thread-messages#webpage\"},\"dateModified\":\"2026-11-19T05:44:28.870Z\",\"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/list-thread-messages.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","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","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","description":"Returns thread metadata, message IDs, participants, last message, unread count, and state for one conversation. Responses include a weak `ETag` header.","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","description":"Returns a cursor-paginated clean JSON view of messages in a thread. Attachment output is metadata only; attachment contents are not parsed by this endpoint.","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":"List thread messages - 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"]}