Message information object.
media and recording_url are mutually exclusive by presence based on type_of_message:
for non-call messages the response includes media and omits recording_url;
for call messages the response includes recording_url and omits media.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SalesCaptain Docs","colors":{"primary":"#3B82F6","light":"#60A5FA","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/salescaptain-42c66529/xMG1pWfYHUcTmDKe/logo/Salescaptain-black.png?fit=max\u0026auto=format\u0026n=xMG1pWfYHUcTmDKe\u0026q=85\u0026s=c8b17c0344251b49de4aa9cd215a98ac","dark":"https://mintcdn.com/salescaptain-42c66529/xMG1pWfYHUcTmDKe/logo/Salescaptain-white.png?fit=max\u0026auto=format\u0026n=xMG1pWfYHUcTmDKe\u0026q=85\u0026s=02ad09ff455401a2cddf7cfaaeeee737"},"favicon":"https://mintcdn.com/salescaptain-42c66529/gE5WS-rD11w_xMc8/logo/logo_chatbot.svg?fit=max\u0026auto=format\u0026n=gE5WS-rD11w_xMc8\u0026q=85\u0026s=f0b371aecedcac5dd13f62601b625933","navbar":{"links":[{"href":"https://salescaptain.com","label":"Home"},{"href":"https://calendly.com/aleks-salescaptain/salescaptain-demo","label":"Talk to Us"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.salescaptain.com/login"}},"footer":{"socials":{"website":"https://salescaptain.com/","x":"https://twitter.com/SalesCaptainInc","linkedin":"https://www.linkedin.com/company/salescaptainhq","instagram":"https://www.instagram.com/salescaptainhq","facebook":"https://www.facebook.com/SalesCaptainHQ","reddit":"https://www.reddit.com/r/SalesCaptain"}},"seo":{"metatags":{"og:title":"SalesCaptain Documentation","og:description":"Learn how to use SalesCaptain tools to automate and scale your business enterprise and customer communication.","og:image":"/logo/logo_chatbot.svg","robots":"index, follow","ai-allow":"all","indexing":"all","keywords":"AI automation, lead generation, customer engagement, business growth, marketing automation, CRM software, chat automation, local SEO, reputation management, review generation, workflow automation, Playwright integration, n8n automation, website chat assistant"}},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"salescaptain-42c66529","hasAudioNarration":false,"actualSubdomain":"salescaptain-42c66529","customDomains":["docs.salescaptain.com"],"gitSource":{"type":"github","owner":"salescaptaindocs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a9841d87209647f21a74871","collectionId":"051ac3b7-9bf9-4dc3-a263-5bed686b583e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a9841d87209647f21a74871"},"entitlements":{},"buildId":"6a9842ba5535ad4f4f4f6f7c","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"Guides","count":40},{"language":"default","tag":"Core Features","count":28},{"language":"default","tag":"API reference","count":26},{"language":"default","tag":"Getting started","count":12},{"language":"default","tag":"Contacts","count":10},{"language":"default","tag":"Account Setup","count":8},{"language":"default","tag":"Call Flow","count":6},{"language":"default","tag":"Tags","count":5},{"language":"default","tag":"Calling","count":4},{"language":"default","tag":"Marketing","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":".text-lg.prose p{font-size:17px!important}h1#page-title.text-2xl{font-size:30px!important}"}],"page":{"pagePath":"api-reference/endpoint/fetching-messages-by-message-ID","slug":"/api-reference/endpoint/fetching-messages-by-message-ID","pageMetadata":{"title":"Get a message by ID","openapi":"GET /v1/fetch-message/{message_id}","description":"Retrieves detailed information about a specific message by its unique identifier.\n","href":"/api-reference/endpoint/fetching-messages-by-message-ID"},"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: \"Retrieves detailed information about a specific message by its unique identifier.\"\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 message by ID","openapi":"GET /v1/fetch-message/{message_id}","description":"Retrieves detailed information about a specific message by its unique identifier.\n","href":"/api-reference/endpoint/fetching-messages-by-message-ID"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Fetch a single message by ID","description":"Retrieves detailed information about a specific message by its unique identifier.\n","operationId":"fetchMessage","tags":["Conversations"],"security":["3b901424-7212-4f56-817f-eb2b49f09e47"],"parameters":["e03ea2ce-f4af-4f4d-a770-36ba415d9cf5"],"responses":{"200":"bcef036b-b109-4921-bd65-2d6644c1b5a3","401":"ff66982d-18ee-40b8-ada6-57d63b7e184f","403":"8bf947b8-b6ba-4e5d-8dce-1ee9dbc8b967","429":"2bb8ffdc-130e-4ecf-96f7-27c0c975618c","500":"3ab35e2a-9fe1-41e9-9632-2a84b1f097ce"},"method":"get","type":"path","servers":["d9c7298b-ef79-43f4-90b3-a8f2860e6c73"],"path":"/v1/fetch-message/{message_id}","baseUrlOptions":["https://api.salescaptain.com"],"title":"Fetch a single message by ID","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e03ea2ce-f4af-4f4d-a770-36ba415d9cf5":{"name":"message_id","in":"path","required":true,"description":"Unique identifier for the message","schema":{"type":"string","format":"uuid","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","isRequired":true,"description":"Unique identifier for the message","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"bcef036b-b109-4921-bd65-2d6644c1b5a3":{"description":"Message fetched successfully or error response","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"message":{"type":"string","example":"Message fetched successfully!","uniqueKey":"oneOf.0.message","typeLabel":"string"},"data":{"type":"object","description":"Message information object.\n`media` and `recording_url` are mutually exclusive by presence based on `type_of_message`:\nfor non-call messages the response includes `media` and omits `recording_url`;\nfor call messages the response includes `recording_url` and omits `media`.\n","properties":{"conversation_id":{"type":"string","format":"uuid","description":"Unique identifier for the conversation","example":"b2c3d4e5-f6a7-8901-bcde-f12345678901","isRequired":true,"uniqueKey":"oneOf.0.data.conversation_id","typeLabel":"string\u003cuuid>"},"message_id":{"type":"string","format":"uuid","description":"Unique identifier for the message","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","isRequired":true,"uniqueKey":"oneOf.0.data.message_id","typeLabel":"string\u003cuuid>"},"contact_id":{"type":"string","format":"uuid","description":"Unique identifier for the contact","example":"f6a7b8c9-d0e1-2345-f123-456789012345","isRequired":true,"uniqueKey":"oneOf.0.data.contact_id","typeLabel":"string\u003cuuid>"},"conversation_profile_id":{"type":"string","format":"uuid","description":"Unique identifier for the conversation profile","example":"c3d4e5f6-a7b8-9012-cdef-123456789012","isRequired":true,"uniqueKey":"oneOf.0.data.conversation_profile_id","typeLabel":"string\u003cuuid>"},"type_of_message":{"type":"string","description":"Type of the message","enum":["sms_message","email_message","ig_message","fb_message","web_chat_message","call"],"example":"sms_message","isRequired":true,"uniqueKey":"oneOf.0.data.type_of_message","typeLabel":"enum\u003cstring>"},"direction":{"type":"string","description":"Direction of the message","enum":["inbound","outbound"],"example":"inbound","isRequired":true,"uniqueKey":"oneOf.0.data.direction","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","description":"Timestamp when the message was created","example":"2026-03-15T08:00:00.000Z","isRequired":true,"uniqueKey":"oneOf.0.data.created_at","typeLabel":"string\u003cdate-time>"},"conversation_profile_email":{"oneOf":[{"type":"string","format":"email","description":"Email address of the conversation profile","example":"[email protected]","uniqueKey":"oneOf.0.data.conversation_profile_email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","description":"Email address of the conversation profile","example":"[email protected]","uniqueKey":"oneOf.0.data.conversation_profile_email.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.conversation_profile_email","typeLabel":"string\u003cemail> | null"},"conversation_profile_number":{"oneOf":[{"type":"string","description":"Phone number of the conversation profile","example":"+1987654321","uniqueKey":"oneOf.0.data.conversation_profile_number.oneOf.0","typeLabel":"string"},{"type":"null","description":"Phone number of the conversation profile","example":"+1987654321","uniqueKey":"oneOf.0.data.conversation_profile_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.conversation_profile_number","typeLabel":"string | null"},"message":{"oneOf":[{"type":"string","description":"Message body/text content","example":"Hi, I'd like to schedule an appointment.","uniqueKey":"oneOf.0.data.message.oneOf.0","typeLabel":"string"},{"type":"null","description":"Message body/text content","example":"Hi, I'd like to schedule an appointment.","uniqueKey":"oneOf.0.data.message.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.message","typeLabel":"string | null"},"media":{"type":"array","description":"Media attachments (e.g. image/file URLs).\nPresent only when type_of_message is not call. Omitted for call messages (replaced by recording_url).\n","items":{"type":"string","uniqueKey":"oneOf.0.data.media.items.[INDEX]","typeLabel":"string"},"example":["https://cdn.example.com/media/image1.jpg"],"uniqueKey":"oneOf.0.data.media","typeLabel":"string[]"},"recording_url":{"type":"string","format":"uri","description":"Call recording URL.\nPresent only when type_of_message is call. Omitted for non-call messages (replaced by media).\n","example":"https://cdn.example.com/recordings/call123.mp3","uniqueKey":"oneOf.0.data.recording_url","typeLabel":"string\u003curi>"},"call_status":{"oneOf":[{"type":"string","description":"Status of the call when the message is a call (null for non-call messages)","example":"completed","uniqueKey":"oneOf.0.data.call_status.oneOf.0","typeLabel":"string"},{"type":"null","description":"Status of the call when the message is a call (null for non-call messages)","example":"completed","uniqueKey":"oneOf.0.data.call_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.call_status","typeLabel":"string | null"},"call_duration":{"oneOf":[{"type":"integer","description":"Call duration in seconds when the message is a call (null for non-call messages)","example":125,"uniqueKey":"oneOf.0.data.call_duration.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Call duration in seconds when the message is a call (null for non-call messages)","example":125,"uniqueKey":"oneOf.0.data.call_duration.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.call_duration","typeLabel":"integer | null"},"assigned_account_id":{"oneOf":[{"type":"string","format":"uuid","description":"Account ID of the agent assigned at the time of the message","example":"d4e5f6a7-b8c9-0123-def1-234567890123","uniqueKey":"oneOf.0.data.assigned_account_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Account ID of the agent assigned at the time of the message","example":"d4e5f6a7-b8c9-0123-def1-234567890123","uniqueKey":"oneOf.0.data.assigned_account_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.assigned_account_id","typeLabel":"string\u003cuuid> | null"}},"required":["conversation_id","message_id","contact_id","conversation_profile_id","type_of_message","direction","created_at"],"uniqueKey":"oneOf.0.data","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Standard failure response returned with HTTP 200 status","required":["status","error","message"],"properties":{"status":{"type":"string","description":"Always \"failure\" for error responses","example":"failure","isRequired":true,"uniqueKey":"oneOf.1.status","typeLabel":"string"},"error":{"type":"string","description":"Error description (may contain stringified JSON)","example":"Problem encountered while fetching messages!","isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"string"},"message":{"type":"string","description":"Error message (may contain stringified JSON)","example":"Company not found","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"},"trace":{"type":"array","description":"Stack trace (included in non-production environments)","items":{"type":"string","uniqueKey":"oneOf.1.trace.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.1.trace","typeLabel":"string[]"},"request":{"type":"object","description":"Original request details","properties":{"body":{"type":"object","uniqueKey":"oneOf.1.request.body","typeLabel":"object"},"method":{"type":"string","uniqueKey":"oneOf.1.request.method","typeLabel":"string"},"url":{"type":"string","uniqueKey":"oneOf.1.request.url","typeLabel":"string"},"params":{"type":"object","uniqueKey":"oneOf.1.request.params","typeLabel":"object"}},"uniqueKey":"oneOf.1.request","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"success":{"title":"success","value":{"message":"Message fetched successfully!","data":{"conversation_id":"b2c3d4e5-f6a7-8901-bcde-f12345678901","message_id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","contact_id":"f6a7b8c9-d0e1-2345-f123-456789012345","conversation_profile_id":"c3d4e5f6-a7b8-9012-cdef-123456789012","conversation_profile_email":"[email protected]","conversation_profile_number":"+1987654321","type_of_message":"sms_message","direction":"inbound","message":"Hi, I'd like to schedule an appointment.","media":["https://cdn.example.com/media/image1.jpg"],"call_status":null,"call_duration":null,"assigned_account_id":"d4e5f6a7-b8c9-0123-def1-234567890123","created_at":"2026-03-15T08:00:00.000Z"}}},"missing_message_id":{"title":"missing_message_id","value":{"status":"failure","error":"{\"is_error\":true,\"error\":\"message_id must be provided!\",\"message\":\"message_id must be provided!\"}","message":"{\"is_error\":true,\"error\":\"message_id must be provided!\",\"message\":\"message_id must be provided!\"}"}},"message_not_found":{"title":"message_not_found","value":{"status":"failure","error":"{\"is_error\":true,\"error\":\"Message not found\",\"message\":\"Message not found\"}","message":"{\"is_error\":true,\"error\":\"Message not found\",\"message\":\"Message not found\"}"}},"conversation_not_found":{"title":"conversation_not_found","value":{"status":"failure","error":"{\"is_error\":true,\"error\":\"Conversation not found\",\"message\":\"Conversation not found\"}","message":"{\"is_error\":true,\"error\":\"Conversation not found\",\"message\":\"Conversation not found\"}"}},"company_api_error":{"title":"company_api_error","value":{"status":"failure","error":"Problem encountered while fetching message!","message":"Company not found"}},"unexpected_error":{"title":"unexpected_error","value":{"status":"failure","error":"Problem encountered while fetching message!","message":"connect ECONNREFUSED"}}},"exampleType":"examples"}},"exampleType":"examples"},"ff66982d-18ee-40b8-ada6-57d63b7e184f":{"description":"Authentication token is missing or invalid","content":{"application/json":{"schema":{"type":"object","description":"Error response object","properties":{"error":{"type":"string","description":"Error message","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Error code for programmatic handling","example":"INVALID_PARAMS","uniqueKey":"code","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"Timestamp when the error occurred","example":"2023-12-01T10:30:00Z","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"path":{"type":"string","description":"API endpoint path where the error occurred","example":"/v1/fetch-companies","uniqueKey":"path","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"Unauthorized access","code":"UNAUTHORIZED","timestamp":"2023-12-01T10:30:00Z","path":"/v1/fetch-companies"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized access","code":"UNAUTHORIZED","timestamp":"2023-12-01T10:30:00Z","path":"/v1/fetch-companies"}}},"exampleType":"examples"}},"exampleType":"examples"},"8bf947b8-b6ba-4e5d-8dce-1ee9dbc8b967":{"description":"Access forbidden - valid token but insufficient permissions","content":{"application/json":{"schema":{"type":"object","description":"Error response object","properties":{"error":{"type":"string","description":"Error message","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Error code for programmatic handling","example":"INVALID_PARAMS","uniqueKey":"code","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"Timestamp when the error occurred","example":"2023-12-01T10:30:00Z","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"path":{"type":"string","description":"API endpoint path where the error occurred","example":"/v1/fetch-companies","uniqueKey":"path","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"Forbidden access","code":"FORBIDDEN","timestamp":"2023-12-01T10:30:00Z","path":"/v1/fetch-companies"},"examples":{"Example":{"title":"Example","value":{"error":"Forbidden access","code":"FORBIDDEN","timestamp":"2023-12-01T10:30:00Z","path":"/v1/fetch-companies"}}},"exampleType":"examples"}},"exampleType":"examples"},"2bb8ffdc-130e-4ecf-96f7-27c0c975618c":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","description":"Error response object","properties":{"error":{"type":"string","description":"Error message","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Error code for programmatic handling","example":"INVALID_PARAMS","uniqueKey":"code","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"Timestamp when the error occurred","example":"2023-12-01T10:30:00Z","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"path":{"type":"string","description":"API endpoint path where the error occurred","example":"/v1/fetch-companies","uniqueKey":"path","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"Too many requests, please try again later","code":"RATE_LIMIT_EXCEEDED","timestamp":"2023-12-01T10:30:00Z","path":"/v1/fetch-companies"},"examples":{"Example":{"title":"Example","value":{"error":"Too many requests, please try again later","code":"RATE_LIMIT_EXCEEDED","timestamp":"2023-12-01T10:30:00Z","path":"/v1/fetch-companies"}}},"exampleType":"examples"}},"headers":{"X-RateLimit-Limit":{"description":"Request limit per time window","schema":{"type":"integer","example":30}},"X-RateLimit-Remaining":{"description":"Remaining requests in current window","schema":{"type":"integer","example":0}},"X-RateLimit-Reset":{"description":"Time when the rate limit resets","schema":{"type":"integer","example":1701425400}}},"exampleType":"examples"},"3ab35e2a-9fe1-41e9-9632-2a84b1f097ce":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","description":"Error response object","properties":{"error":{"type":"string","description":"Error message","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Error code for programmatic handling","example":"INVALID_PARAMS","uniqueKey":"code","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"Timestamp when the error occurred","example":"2023-12-01T10:30:00Z","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"path":{"type":"string","description":"API endpoint path where the error occurred","example":"/v1/fetch-companies","uniqueKey":"path","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"Problem encountered while fetching companies!","code":"INTERNAL_ERROR","timestamp":"2023-12-01T10:30:00Z","path":"/v1/fetch-companies"},"examples":{"Example":{"title":"Example","value":{"error":"Problem encountered while fetching companies!","code":"INTERNAL_ERROR","timestamp":"2023-12-01T10:30:00Z","path":"/v1/fetch-companies"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"3b901424-7212-4f56-817f-eb2b49f09e47":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Authentication token required for accessing protected endpoints.\nThe token should be obtained from the main SalesCaptain authentication service.\n","scopes":[]}}},"servers":{"d9c7298b-ef79-43f4-90b3-a8f2860e6c73":{"url":"https://api.salescaptain.com","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Authentication token required for accessing protected endpoints.\nThe token should be obtained from the main SalesCaptain authentication service.\n","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Authentication token required for accessing protected endpoints.\nThe token should be obtained from the main SalesCaptain authentication service.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"salescaptain-42c66529","siteName":"SalesCaptain Docs","title":"SalesCaptain Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-18T11:20:02.963Z","originalFileLocation":"api-reference/endpoint/fetching-messages-by-message-ID.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieves detailed information about a specific message by its unique identifier.\">\u003cmeta data-mint-head name=\"keywords\" content=\"AI automation, lead generation, customer engagement, business growth, marketing automation, CRM software, chat automation, local SEO, reputation management, review generation, workflow automation, Playwright integration, n8n automation, website chat assistant\">\u003cmeta data-mint-head name=\"application-name\" content=\"SalesCaptain Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/salescaptain-42c66529/As98Wa2R9yXaRT_5/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/salescaptain-42c66529/As98Wa2R9yXaRT_5/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/salescaptain-42c66529/As98Wa2R9yXaRT_5/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/salescaptain-42c66529/As98Wa2R9yXaRT_5/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/salescaptain-42c66529/As98Wa2R9yXaRT_5/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/salescaptain-42c66529/As98Wa2R9yXaRT_5/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/salescaptain-42c66529/As98Wa2R9yXaRT_5/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/salescaptain-42c66529/As98Wa2R9yXaRT_5/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/salescaptain-42c66529/As98Wa2R9yXaRT_5/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"SalesCaptain Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Learn how to use SalesCaptain tools to automate and scale your business enterprise and customer communication.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SalesCaptain Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.salescaptain.com/api-reference/endpoint/fetching-messages-by-message-ID\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://salescaptain-42c66529.mintlify.app/logo/logo_chatbot.svg\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"SalesCaptain Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Learn how to use SalesCaptain tools to automate and scale your business enterprise and customer communication.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://salescaptain-42c66529.mintlify.app/logo/logo_chatbot.svg\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/salescaptain-42c66529/As98Wa2R9yXaRT_5/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SalesCaptain Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B82F6\">\u003cmeta data-mint-head name=\"ai-allow\" content=\"all\">\u003cmeta data-mint-head name=\"indexing\" content=\"all\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.salescaptain.com/api-reference/endpoint/fetching-messages-by-message-ID\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/fetching-messages-by-message-ID.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.salescaptain.com/#organization\",\"name\":\"SalesCaptain Docs\",\"url\":\"https://docs.salescaptain.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/salescaptain-42c66529/xMG1pWfYHUcTmDKe/logo/Salescaptain-black.png?fit=max\u0026auto=format\u0026n=xMG1pWfYHUcTmDKe\u0026q=85\u0026s=c8b17c0344251b49de4aa9cd215a98ac\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.salescaptain.com#website\",\"name\":\"SalesCaptain Docs\",\"url\":\"https://docs.salescaptain.com\",\"publisher\":{\"@id\":\"https://docs.salescaptain.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.salescaptain.com/api-reference/endpoint/fetching-messages-by-message-ID#webpage\",\"url\":\"https://docs.salescaptain.com/api-reference/endpoint/fetching-messages-by-message-ID\",\"name\":\"Get a message by ID\",\"description\":\"Retrieves detailed information about a specific message by its unique identifier.\",\"dateModified\":\"2026-03-18T11:20:02.963Z\",\"isPartOf\":{\"@id\":\"https://docs.salescaptain.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.salescaptain.com/api-reference/endpoint/fetching-messages-by-message-ID#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.salescaptain.com/api-reference/endpoint/fetching-messages-by-message-ID#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SalesCaptain Docs\",\"item\":\"https://docs.salescaptain.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a message by ID\",\"item\":\"https://docs.salescaptain.com/api-reference/endpoint/fetching-messages-by-message-ID\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.salescaptain.com/api-reference/endpoint/fetching-messages-by-message-ID#apireference\",\"headline\":\"Get a message by ID\",\"name\":\"Get a message by ID\",\"description\":\"Retrieves detailed information about a specific message by its unique identifier.\",\"url\":\"https://docs.salescaptain.com/api-reference/endpoint/fetching-messages-by-message-ID\",\"mainEntityOfPage\":{\"@id\":\"https://docs.salescaptain.com/api-reference/endpoint/fetching-messages-by-message-ID#webpage\"},\"image\":\"https://docs.salescaptain.com/logo/logo_chatbot.svg\",\"dateModified\":\"2026-03-18T11:20:02.963Z\",\"publisher\":{\"@id\":\"https://docs.salescaptain.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.salescaptain.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SalesCaptain Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"SalesCaptain Docs","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open-text","pages":[{"title":"Guides","href":"/General/Account/Account-Settings"}]},{"tab":"API reference","icon":"separator-vertical","groups":[{"group":"API documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Companies","pages":[{"title":"List companies","openapi":"GET /v1/fetch-companies","href":"/api-reference/endpoint/List-companies-by-ID"},{"title":"Get a company by ID","openapi":"GET /v1/fetch-company/{company_id}","href":"/api-reference/endpoint/Fetching-companies-by-Id"}]},{"group":"Accounts","pages":[{"title":"List accounts by ID","openapi":"GET /v1/fetch-all-accounts/{company_id}","href":"/api-reference/endpoint/Fetching-all-accounts"},{"title":"Get an account by ID","openapi":"GET /v1/fetch-account/{account_id}","href":"/api-reference/endpoint/Fetching-account-by-ID"}]},{"group":"Conversations","pages":[{"title":"List conversations by company ID","openapi":"GET /v1/list-conversations/{company_id}","href":"/api-reference/endpoint/list-of-conversations-by-company-ID"},{"title":"Get a conversation by ID","openapi":"GET /v1/fetch-conversation/{conversation_id}","href":"/api-reference/endpoint/Fetching-conversations-by-conversation-id"}]},{"group":"Conversation Profiles","pages":[{"title":"List conversation profiles","openapi":"GET /v1/list-conversation-profiles/{company_id}","href":"/api-reference/endpoint/list-of-conversation-profiles"},{"title":"Get a conversation profile by ID","openapi":"GET /v1/list-conversation-profile/{conversation_profile_id}","href":"/api-reference/endpoint/list-of-conversation-profiles-by-ID"}]},{"group":"Contacts","pages":[{"title":"List contacts","openapi":"GET /v1/list-contacts/{company_id}","href":"/api-reference/endpoint/list-contacts-by-company-ID"},{"title":"Create contact","openapi":"POST /v1/create-contact","href":"/api-reference/endpoint/create-contact"},{"title":"Get a contact by ID","openapi":"GET /v1/fetch-contact/{contact_id}","href":"/api-reference/endpoint/fetching-contact-by-contact-id"},{"title":"Delete contact","openapi":"DELETE /v1/delete-contact/{company_id}/{contact_id}","href":"/api-reference/endpoint/delete-contact-by-company-id-contact-id"},{"title":"Update a contact by ID","openapi":"PUT /v1/update-contact/{contact_id}","description":"Updates an existing contact's information.\nAt least one of name, phone, email, or custom_fields must be provided.\nUser must have 'contacts' access role to update contacts.\n","href":"/api-reference/endpoint/update-contact-by-contact-id"}]},{"group":"Messages","pages":[{"title":"Get a message by ID","openapi":"GET /v1/fetch-message/{message_id}","href":"/api-reference/endpoint/fetching-messages-by-message-ID"},{"title":"Send message by ID","openapi":"POST /v1/send-message/{company_id}/{conversation_id}","description":"Sends an outbound message in the given conversation for the specified company.\n`company_id` and `conversation_id` are taken from the URL path. `message_body` is required in the JSON body.\nOptional `template_id` can be provided to send a template message.\n`account_id` is resolved from the authenticated user's account that matches `company_id` (same as other company-scoped routes).\nThe request is forwarded to the chat service as a POST with `company_id` and `conversation_id` in the path.\n","href":"/api-reference/endpoint/send-message-by-id"},{"title":"List all messages by conversation ID","openapi":"GET /v1/fetch-messages/{company_id}/{conversation_id}","href":"/api-reference/endpoint/Fetching-messages-by-company-ID-conversation-ID"}]},{"group":"Tags","pages":[{"title":"List tags for a company","openapi":"GET /v1/list-tags/{company_id}","href":"/api-reference/endpoint/List-tags-for-a-company"},{"title":"Create a new tag","openapi":"POST /v1/create-tag","href":"/api-reference/endpoint/Create-a-new-tag"},{"title":"Delete a tag","openapi":"DELETE /v1/delete-tag/{company_id}/{tag_id}","href":"/api-reference/endpoint/Delete-a-tag"},{"title":"Add a tag to a contact","openapi":"POST /v1/add-tag-to-contact/{company_id}","href":"/api-reference/endpoint/Add-a-tag-to-a-contact"},{"title":"Remove a tag from a contact","openapi":"DELETE /v1/remove-tag-from-contact/{company_id}","href":"/api-reference/endpoint/Remove-a-tag-from-a-contact"}]},{"group":"Templates","pages":[{"title":"List all SMS templates","openapi":"GET /v1/sms/list-templates/{company_id}","href":"/api-reference/endpoint/List-all-SMS-templates"}]},{"group":"Custom Fileds","pages":[{"title":"Get a custom field by ID","openapi":"GET /v1/list-custom-field/{custom_field_id}","href":"/api-reference/endpoint/list-of-custom-field-by-custom-field-id"},{"title":"List custom fields by ID","openapi":"GET /v1/list-custom-fields/{company_id}","href":"/api-reference/endpoint/list-of-custom-fields-by-company-id"}]},{"group":"Analytics","pages":[{"title":"Fetch call analytics by company","openapi":"POST /v1/call-analytics","href":"/api-reference/endpoint/Fetch-call-analytics-by-company"}]}]},{"tab":"MCP","icon":"server","pages":[{"title":"MCP","href":"/mcp/MCP-Serve"}]}]},"title":"SalesCaptain Documentation","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}