{ "id": "thr-b2c3d4e5-f6a7-8901-bcde-f12345678901", "channel_id": "chn_a1b2c3d4e5f6g7h8i9j0k1l2", "channel_type": "WABA", "contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012", "organization_id": "org-f1e2d3c4-b5a6-7890-1234-567890abcdef", "status": "open", "assignee": null, "assignee_type": null, "created_at": "2026-04-06T15:00:00Z", "updated_at": "2026-04-06T15:05:00Z", "referral": { "source_type": "ad", "source_id": "120212345678900123", "source_url": "https://fb.me/2AbCdEfGh", "ctwa_clid": "ARAkLkA8rmlFeiCktEJQ-QTwRiyYHAFDLMNDBH0CD3qpjd0HR4irJ6LEkR7JwFF4XvnO2E4Nx0-eM-GABDLOPaOdRMv-_zfUQ2a", "headline": "2x1 pizzas every Tuesday", "body": "Order on WhatsApp and get the second pizza free.", "media_type": "image", "image_url": "https://scontent.xx.fbcdn.net/v/t45.1600-4/example.jpg?oe=6801A2B3", "welcome_message": { "text": "Hi! I want the 2x1 promo" } }}
Returns the details of a specific conversation thread, including its channel, contact, status, assignee and, when the conversation started from a Meta ad or post, its referral.
Headers
string
requerido
Your API key for authentication.
Path Parameters
string
requerido
The UUID of the thread to retrieve.
Response
string
Unique identifier of the thread (UUID).
string
UUID of the channel this thread belongs to.
string
Type of the channel (e.g. WABA, INSTAGRAM).
string
UUID of the contact in this thread.
string
UUID of the organization that owns this thread.
string
Thread status (e.g. open, closed).
string
UUID of the user or agent currently assigned to this thread.
string
Type of the assignee: user or agent.
string
Timestamp when the thread was created (ISO 8601).
string
Timestamp of the last update (ISO 8601).
object | null
Where the conversation came from, as Meta reported it in the contact’s first message. Present when someone wrote from a Click-to-WhatsApp ad, a post or a page; null for organic conversations. Fields Meta did not send are left out, so check each one before using it.
Mostrar Referral object
string
What the contact clicked: ad, post or page.
string
Meta ID of the ad or post. For ads, this is the ad ID in Ads Manager.
string
Link to the ad or post on Facebook or Instagram.
string
Click ID of the Click-to-WhatsApp ad. Use it with the Meta Conversions API to attribute a lead or a purchase to the ad (see below). Meta omits it in some cases, such as ads shown in WhatsApp Status.
string
Ad or post headline.
string
Ad or post text.
string
Type of media in the ad: image or video.
string
Image of the ad, when media_type is image.
string
Link to the video of the ad, when media_type is video.
string
Thumbnail of the video, when media_type is video.
object
Pre-filled message the ad suggested to the contact, as { "text": "..." }.
string
Custom ref parameter of the link, when the ad or the link set one.
image_url, video_url and thumbnail_url are signed Meta URLs and expire after a few days. Download the media when you receive it if you need to keep it; don’t store the URL.
Ad attribution with the Conversions API
referral.ctwa_clid is the identifier Meta asks for to attribute a conversion from a WhatsApp conversation to the ad that started it. When the contact converts (a lead, a purchase), send the event to the Conversions API of your dataset with:
action_source: business_messaging
messaging_channel: whatsapp
user_data.ctwa_clid: the ctwa_clid of the thread
user_data.whatsapp_business_account_id: the ID of your WhatsApp Business account
{ "id": "thr-b2c3d4e5-f6a7-8901-bcde-f12345678901", "channel_id": "chn_a1b2c3d4e5f6g7h8i9j0k1l2", "channel_type": "WABA", "contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012", "organization_id": "org-f1e2d3c4-b5a6-7890-1234-567890abcdef", "status": "open", "assignee": null, "assignee_type": null, "created_at": "2026-04-06T15:00:00Z", "updated_at": "2026-04-06T15:05:00Z", "referral": { "source_type": "ad", "source_id": "120212345678900123", "source_url": "https://fb.me/2AbCdEfGh", "ctwa_clid": "ARAkLkA8rmlFeiCktEJQ-QTwRiyYHAFDLMNDBH0CD3qpjd0HR4irJ6LEkR7JwFF4XvnO2E4Nx0-eM-GABDLOPaOdRMv-_zfUQ2a", "headline": "2x1 pizzas every Tuesday", "body": "Order on WhatsApp and get the second pizza free.", "media_type": "image", "image_url": "https://scontent.xx.fbcdn.net/v/t45.1600-4/example.jpg?oe=6801A2B3", "welcome_message": { "text": "Hi! I want the 2x1 promo" } }}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"ContactShip Docs","colors":{"primary":"#0252ff","light":"#1E89FF","dark":"#0252ff"},"logo":{"light":"https://mintcdn.com/contactship/XJKLcqzvszyHAh2b/logo/Isologotipo.png?fit=max\u0026auto=format\u0026n=XJKLcqzvszyHAh2b\u0026q=85\u0026s=1100afd12fc8debe15faade6766a53c7","dark":"https://mintcdn.com/contactship/XJKLcqzvszyHAh2b/logo/Isologotipo.png?fit=max\u0026auto=format\u0026n=XJKLcqzvszyHAh2b\u0026q=85\u0026s=1100afd12fc8debe15faade6766a53c7"},"favicon":"https://mintcdn.com/contactship/XJKLcqzvszyHAh2b/favicon2.png?fit=max\u0026auto=format\u0026n=XJKLcqzvszyHAh2b\u0026q=85\u0026s=2522034f500b8c3c60f46aed56daad87","api":{"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.contactship.ai"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"es","default":true,"href":"es/comenzar/que-es-contactship"},{"language":"en","href":"en/get-started/what-is-contactship"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"contactship","hasAudioNarration":false,"actualSubdomain":"contactship","customDomains":["docs.contactship.ai"],"gitSource":{"type":"github","owner":"serranomatias","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afddde1e3a51766e8138724","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"en","tag":"Documentation","count":87},{"language":"es","tag":"Documentación","count":87},{"language":"default","tag":"API Reference","count":52},{"language":"en","tag":"Integrations","count":13},{"language":"es","tag":"Integraciones","count":13},{"language":"default","tag":"Contactos","count":12},{"language":"en","tag":"Use cases","count":12},{"language":"es","tag":"Casos de uso","count":12},{"language":"en","tag":"Voice agents","count":10},{"language":"es","tag":"Agentes de voz","count":10},{"language":"en","tag":"Contacts","count":8},{"language":"en","tag":"Messages","count":8},{"language":"es","tag":"Contactos","count":8},{"language":"es","tag":"Mensajes","count":8},{"language":"en","tag":"Get started","count":7},{"language":"en","tag":"Organization","count":7},{"language":"es","tag":"Comenzar","count":7},{"language":"es","tag":"Organización","count":7},{"language":"default","tag":"Agentes","count":6},{"language":"default","tag":"Canales y conversaciones","count":6},{"language":"default","tag":"Documentación API","count":6},{"language":"en","tag":"Calls","count":6},{"language":"en","tag":"Text agents","count":6},{"language":"es","tag":"Agentes de texto","count":6},{"language":"es","tag":"Llamadas","count":6},{"language":"default","tag":"WhatsApp (WABA)","count":5},{"language":"default","tag":"Etiquetas","count":4},{"language":"default","tag":"Llamadas","count":4},{"language":"default","tag":"Tareas","count":3},{"language":"default","tag":"Eventos","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"globals.css","content":".rounded-image{border-radius:8px}"}],"page":{"pagePath":"api-reference/endpoint/get-thread","slug":"/api-reference/endpoint/get-thread","pageMetadata":{"title":"Get Thread","api":"GET /v1/thread/{threadId}","description":"Retrieve a conversation thread by its ID","href":"/api-reference/endpoint/get-thread"},"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: \"Retrieve a conversation thread by its ID\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,ResponseField,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Returns the details of a specific conversation thread, including its channel, contact, status, assignee and, when the conversation started from a Meta ad or post, its `,_jsx(_components.code,{children:`referral`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`x-api-key`,type:`string`,required:true,id:`param-x-api-key`,children:_jsx(_components.p,{children:`Your API key for authentication.`})}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path Parameters`}),`\n`,_jsx(ParamField,{path:`threadId`,type:`string`,required:true,id:`param-thread-id`,children:_jsx(_components.p,{children:`The UUID of the thread to retrieve.`})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsx(_components.p,{children:`Unique identifier of the thread (UUID).`})}),`\n`,_jsx(ResponseField,{name:`channel_id`,type:`string`,id:`param-channel-id`,children:_jsx(_components.p,{children:`UUID of the channel this thread belongs to.`})}),`\n`,_jsx(ResponseField,{name:`channel_type`,type:`string`,id:`param-channel-type`,children:_jsxs(_components.p,{children:[`Type of the channel (e.g. `,_jsx(_components.code,{children:`WABA`}),`, `,_jsx(_components.code,{children:`INSTAGRAM`}),`).`]})}),`\n`,_jsx(ResponseField,{name:`contact_id`,type:`string`,id:`param-contact-id`,children:_jsx(_components.p,{children:`UUID of the contact in this thread.`})}),`\n`,_jsx(ResponseField,{name:`organization_id`,type:`string`,id:`param-organization-id`,children:_jsx(_components.p,{children:`UUID of the organization that owns this thread.`})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Thread status (e.g. `,_jsx(_components.code,{children:`open`}),`, `,_jsx(_components.code,{children:`closed`}),`).`]})}),`\n`,_jsx(ResponseField,{name:`assignee`,type:`string`,id:`param-assignee`,children:_jsx(_components.p,{children:`UUID of the user or agent currently assigned to this thread.`})}),`\n`,_jsx(ResponseField,{name:`assignee_type`,type:`string`,id:`param-assignee-type`,children:_jsxs(_components.p,{children:[`Type of the assignee: `,_jsx(_components.code,{children:`user`}),` or `,_jsx(_components.code,{children:`agent`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`created_at`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`Timestamp when the thread was created (ISO 8601).`})}),`\n`,_jsx(ResponseField,{name:`updated_at`,type:`string`,id:`param-updated-at`,children:_jsx(_components.p,{children:`Timestamp of the last update (ISO 8601).`})}),`\n`,_jsxs(ResponseField,{name:`referral`,type:`object | null`,id:`param-referral`,children:[_jsxs(_components.p,{children:[`Where the conversation came from, as Meta reported it in the contact’s first message. Present when someone wrote from a Click-to-WhatsApp ad, a post or a page; `,_jsx(_components.code,{children:`null`}),` for organic conversations. Fields Meta did not send are left out, so check each one before using it.`]}),_jsxs(Expandable,{title:`Referral object`,children:[_jsxs(ResponseField,{name:`source_type`,type:`string`,id:`param-source-type`,children:[`What the contact clicked: `,_jsx(_components.code,{children:`ad`}),`, `,_jsx(_components.code,{children:`post`}),` or `,_jsx(_components.code,{children:`page`}),`.`]}),_jsx(ResponseField,{name:`source_id`,type:`string`,id:`param-source-id`,children:`Meta ID of the ad or post. For ads, this is the ad ID in Ads Manager.`}),_jsx(ResponseField,{name:`source_url`,type:`string`,id:`param-source-url`,children:`Link to the ad or post on Facebook or Instagram.`}),_jsx(ResponseField,{name:`ctwa_clid`,type:`string`,id:`param-ctwa-clid`,children:`Click ID of the Click-to-WhatsApp ad. Use it with the Meta Conversions API to attribute a lead or a purchase to the ad (see below). Meta omits it in some cases, such as ads shown in WhatsApp Status.`}),_jsx(ResponseField,{name:`headline`,type:`string`,id:`param-headline`,children:`Ad or post headline.`}),_jsx(ResponseField,{name:`body`,type:`string`,id:`param-body`,children:`Ad or post text.`}),_jsxs(ResponseField,{name:`media_type`,type:`string`,id:`param-media-type`,children:[`Type of media in the ad: `,_jsx(_components.code,{children:`image`}),` or `,_jsx(_components.code,{children:`video`}),`.`]}),_jsxs(ResponseField,{name:`image_url`,type:`string`,id:`param-image-url`,children:[`Image of the ad, when `,_jsx(_components.code,{children:`media_type`}),` is `,_jsx(_components.code,{children:`image`}),`.`]}),_jsxs(ResponseField,{name:`video_url`,type:`string`,id:`param-video-url`,children:[`Link to the video of the ad, when `,_jsx(_components.code,{children:`media_type`}),` is `,_jsx(_components.code,{children:`video`}),`.`]}),_jsxs(ResponseField,{name:`thumbnail_url`,type:`string`,id:`param-thumbnail-url`,children:[`Thumbnail of the video, when `,_jsx(_components.code,{children:`media_type`}),` is `,_jsx(_components.code,{children:`video`}),`.`]}),_jsxs(ResponseField,{name:`welcome_message`,type:`object`,id:`param-welcome-message`,children:[`Pre-filled message the ad suggested to the contact, as `,_jsx(_components.code,{children:`{ \"text\": \"...\" }`}),`.`]}),_jsxs(ResponseField,{name:`ref`,type:`string`,id:`param-ref`,children:[`Custom `,_jsx(_components.code,{children:`ref`}),` parameter of the link, when the ad or the link set one.`]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`image_url`}),`, `,_jsx(_components.code,{children:`video_url`}),` and `,_jsx(_components.code,{children:`thumbnail_url`}),` are signed Meta URLs and expire after a few days. Download the media when you receive it if you need to keep it; don’t store the URL.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`ad-attribution-with-the-conversions-api`,children:`Ad attribution with the Conversions API`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`referral.ctwa_clid`}),` is the identifier Meta asks for to attribute a conversion from a WhatsApp conversation to the ad that started it. When the contact converts (a lead, a purchase), send the event to the `,_jsx(_components.a,{href:`https://developers.facebook.com/docs/marketing-api/conversions-api/business-messaging`,children:`Conversions API`}),` of your dataset with:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`action_source`}),`: `,_jsx(_components.code,{children:`business_messaging`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`messaging_channel`}),`: `,_jsx(_components.code,{children:`whatsapp`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`user_data.ctwa_clid`}),`: the `,_jsx(_components.code,{children:`ctwa_clid`}),` of the thread`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`user_data.whatsapp_business_account_id`}),`: the ID of your WhatsApp Business account`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://graph.facebook.com/v21.0/{DATASET_ID}/events?access_token={TOKEN}\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": [{`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"event_name\": \"Purchase\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"event_time\": 1775487600,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action_source\": \"business_messaging\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"messaging_channel\": \"whatsapp\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"user_data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"ctwa_clid\": \"ARAkLkA8rmlFeiCktEJQ-QTwRiyYHAFDLMNDBH0CD3qpjd0HR4irJ6LEkR7JwFF4XvnO2E4Nx0-eM-GABDLOPaOdRMv-_zfUQ2a\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"whatsapp_business_account_id\": \"1234567890123456\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"custom_data\": { \"currency\": \"USD\", \"value\": 49.9 }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`referral.source_id`}),` is the ad ID: use it to match the conversation with the ad’s results in Ads Manager.`]}),`\n`,_jsx(Heading,{level:`2`,id:`error-codes`,children:`Error Codes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`401 Unauthorized`}),` — Invalid or missing API key`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`404 Not Found`}),` — Thread not found or does not belong to your organization`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`500 Internal Server Error`}),` — Server-side error`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`code-examples`,children:`Code Examples`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Thread","api":"GET /v1/thread/{threadId}","description":"Retrieve a conversation thread by its ID","href":"/api-reference/endpoint/get-thread"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,RequestExample,ResponseExample,ResponseField,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Returns the details of a specific conversation thread, including its channel, contact, status, assignee and, when the conversation started from a Meta ad or post, its `,_jsx(_components.code,{children:`referral`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`x-api-key`,type:`string`,required:true,id:`param-x-api-key`,children:_jsx(_components.p,{children:`Your API key for authentication.`})}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path Parameters`}),`\n`,_jsx(ParamField,{path:`threadId`,type:`string`,required:true,id:`param-thread-id`,children:_jsx(_components.p,{children:`The UUID of the thread to retrieve.`})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsx(_components.p,{children:`Unique identifier of the thread (UUID).`})}),`\n`,_jsx(ResponseField,{name:`channel_id`,type:`string`,id:`param-channel-id`,children:_jsx(_components.p,{children:`UUID of the channel this thread belongs to.`})}),`\n`,_jsx(ResponseField,{name:`channel_type`,type:`string`,id:`param-channel-type`,children:_jsxs(_components.p,{children:[`Type of the channel (e.g. `,_jsx(_components.code,{children:`WABA`}),`, `,_jsx(_components.code,{children:`INSTAGRAM`}),`).`]})}),`\n`,_jsx(ResponseField,{name:`contact_id`,type:`string`,id:`param-contact-id`,children:_jsx(_components.p,{children:`UUID of the contact in this thread.`})}),`\n`,_jsx(ResponseField,{name:`organization_id`,type:`string`,id:`param-organization-id`,children:_jsx(_components.p,{children:`UUID of the organization that owns this thread.`})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Thread status (e.g. `,_jsx(_components.code,{children:`open`}),`, `,_jsx(_components.code,{children:`closed`}),`).`]})}),`\n`,_jsx(ResponseField,{name:`assignee`,type:`string`,id:`param-assignee`,children:_jsx(_components.p,{children:`UUID of the user or agent currently assigned to this thread.`})}),`\n`,_jsx(ResponseField,{name:`assignee_type`,type:`string`,id:`param-assignee-type`,children:_jsxs(_components.p,{children:[`Type of the assignee: `,_jsx(_components.code,{children:`user`}),` or `,_jsx(_components.code,{children:`agent`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`created_at`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`Timestamp when the thread was created (ISO 8601).`})}),`\n`,_jsx(ResponseField,{name:`updated_at`,type:`string`,id:`param-updated-at`,children:_jsx(_components.p,{children:`Timestamp of the last update (ISO 8601).`})}),`\n`,_jsxs(ResponseField,{name:`referral`,type:`object | null`,id:`param-referral`,children:[_jsxs(_components.p,{children:[`Where the conversation came from, as Meta reported it in the contact’s first message. Present when someone wrote from a Click-to-WhatsApp ad, a post or a page; `,_jsx(_components.code,{children:`null`}),` for organic conversations. Fields Meta did not send are left out, so check each one before using it.`]}),_jsxs(Expandable,{title:`Referral object`,children:[_jsxs(ResponseField,{name:`source_type`,type:`string`,id:`param-source-type`,children:[`What the contact clicked: `,_jsx(_components.code,{children:`ad`}),`, `,_jsx(_components.code,{children:`post`}),` or `,_jsx(_components.code,{children:`page`}),`.`]}),_jsx(ResponseField,{name:`source_id`,type:`string`,id:`param-source-id`,children:`Meta ID of the ad or post. For ads, this is the ad ID in Ads Manager.`}),_jsx(ResponseField,{name:`source_url`,type:`string`,id:`param-source-url`,children:`Link to the ad or post on Facebook or Instagram.`}),_jsx(ResponseField,{name:`ctwa_clid`,type:`string`,id:`param-ctwa-clid`,children:`Click ID of the Click-to-WhatsApp ad. Use it with the Meta Conversions API to attribute a lead or a purchase to the ad (see below). Meta omits it in some cases, such as ads shown in WhatsApp Status.`}),_jsx(ResponseField,{name:`headline`,type:`string`,id:`param-headline`,children:`Ad or post headline.`}),_jsx(ResponseField,{name:`body`,type:`string`,id:`param-body`,children:`Ad or post text.`}),_jsxs(ResponseField,{name:`media_type`,type:`string`,id:`param-media-type`,children:[`Type of media in the ad: `,_jsx(_components.code,{children:`image`}),` or `,_jsx(_components.code,{children:`video`}),`.`]}),_jsxs(ResponseField,{name:`image_url`,type:`string`,id:`param-image-url`,children:[`Image of the ad, when `,_jsx(_components.code,{children:`media_type`}),` is `,_jsx(_components.code,{children:`image`}),`.`]}),_jsxs(ResponseField,{name:`video_url`,type:`string`,id:`param-video-url`,children:[`Link to the video of the ad, when `,_jsx(_components.code,{children:`media_type`}),` is `,_jsx(_components.code,{children:`video`}),`.`]}),_jsxs(ResponseField,{name:`thumbnail_url`,type:`string`,id:`param-thumbnail-url`,children:[`Thumbnail of the video, when `,_jsx(_components.code,{children:`media_type`}),` is `,_jsx(_components.code,{children:`video`}),`.`]}),_jsxs(ResponseField,{name:`welcome_message`,type:`object`,id:`param-welcome-message`,children:[`Pre-filled message the ad suggested to the contact, as `,_jsx(_components.code,{children:`{ \"text\": \"...\" }`}),`.`]}),_jsxs(ResponseField,{name:`ref`,type:`string`,id:`param-ref`,children:[`Custom `,_jsx(_components.code,{children:`ref`}),` parameter of the link, when the ad or the link set one.`]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`image_url`}),`, `,_jsx(_components.code,{children:`video_url`}),` and `,_jsx(_components.code,{children:`thumbnail_url`}),` are signed Meta URLs and expire after a few days. Download the media when you receive it if you need to keep it; don’t store the URL.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`ad-attribution-with-the-conversions-api`,children:`Ad attribution with the Conversions API`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`referral.ctwa_clid`}),` is the identifier Meta asks for to attribute a conversion from a WhatsApp conversation to the ad that started it. When the contact converts (a lead, a purchase), send the event to the `,_jsx(_components.a,{href:`https://developers.facebook.com/docs/marketing-api/conversions-api/business-messaging`,children:`Conversions API`}),` of your dataset with:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`action_source`}),`: `,_jsx(_components.code,{children:`business_messaging`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`messaging_channel`}),`: `,_jsx(_components.code,{children:`whatsapp`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`user_data.ctwa_clid`}),`: the `,_jsx(_components.code,{children:`ctwa_clid`}),` of the thread`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`user_data.whatsapp_business_account_id`}),`: the ID of your WhatsApp Business account`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://graph.facebook.com/v21.0/{DATASET_ID}/events?access_token={TOKEN}\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": [{`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"event_name\": \"Purchase\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"event_time\": 1775487600,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action_source\": \"business_messaging\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"messaging_channel\": \"whatsapp\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"user_data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"ctwa_clid\": \"ARAkLkA8rmlFeiCktEJQ-QTwRiyYHAFDLMNDBH0CD3qpjd0HR4irJ6LEkR7JwFF4XvnO2E4Nx0-eM-GABDLOPaOdRMv-_zfUQ2a\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"whatsapp_business_account_id\": \"1234567890123456\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"custom_data\": { \"currency\": \"USD\", \"value\": 49.9 }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`referral.source_id`}),` is the ad ID: use it to match the conversation with the ad’s results in Ads Manager.`]}),`\n`,_jsx(Heading,{level:`2`,id:`error-codes`,children:`Error Codes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`401 Unauthorized`}),` — Invalid or missing API key`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`404 Not Found`}),` — Thread not found or does not belong to your organization`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`500 Internal Server Error`}),` — Server-side error`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`code-examples`,children:`Code Examples`}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.contactship.ai/v1/thread/thr-b2c3d4e5-f6a7-8901-bcde-f12345678901\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: your-api-key\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`7`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` threadId`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'thr-b2c3d4e5-f6a7-8901-bcde-f12345678901'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `https://api.contactship.ai/v1/thread/\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`threadId`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'x-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'your-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` thread`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`Thread status: \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`thread`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`8`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`thread_id `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'thr-b2c3d4e5-f6a7-8901-bcde-f12345678901'`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.get(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.contactship.ai/v1/thread/`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`thread_id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'x-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'your-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(response.json())`})]}),`\n`]})})})]}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`Example Response`,numberOfLines:`23`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`23`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"thr-b2c3d4e5-f6a7-8901-bcde-f12345678901\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"channel_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"chn_a1b2c3d4e5f6g7h8i9j0k1l2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"channel_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"WABA\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"contact_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"c1d2e3f4-a5b6-7890-cdef-123456789012\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"organization_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"org-f1e2d3c4-b5a6-7890-1234-567890abcdef\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"open\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"assignee\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"assignee_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-04-06T15:00:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-04-06T15:05:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"referral\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ad\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"120212345678900123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://fb.me/2AbCdEfGh\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ctwa_clid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ARAkLkA8rmlFeiCktEJQ-QTwRiyYHAFDLMNDBH0CD3qpjd0HR4irJ6LEkR7JwFF4XvnO2E4Nx0-eM-GABDLOPaOdRMv-_zfUQ2a\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"headline\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2x1 pizzas every Tuesday\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"body\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Order on WhatsApp and get the second pizza free.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"media_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"image\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"image_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://scontent.xx.fbcdn.net/v/t45.1600-4/example.jpg?oe=6801A2B3\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"welcome_message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"text\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Hi! I want the 2x1 promo\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Thread","api":"GET /v1/thread/{threadId}","description":"Retrieve a conversation thread by its ID","href":"/api-reference/endpoint/get-thread"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Path Parameters","slug":"path-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Ad attribution with the Conversions API","slug":"ad-attribution-with-the-conversions-api","depth":2,"children":[]},{"title":"Error Codes","slug":"error-codes","depth":2,"children":[]},{"title":"Code Examples","slug":"code-examples","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"2\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> GET\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api.contactship.ai/v1/thread/thr-b2c3d4e5-f6a7-8901-bcde-f12345678901\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"x-api-key: your-api-key\"\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"JavaScript","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> threadId\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'thr-b2c3d4e5-f6a7-8901-bcde-f12345678901'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">;\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> response\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> fetch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> `https://api.contactship.ai/v1/thread/\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">threadId\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">headers:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'x-api-key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'your-api-key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> } }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> thread\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">();\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`Thread status: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">thread\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">status\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"python\">\u003ccode language=\"python\" numberOfLines=\"8\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">thread_id \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'thr-b2c3d4e5-f6a7-8901-bcde-f12345678901'\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">response \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests.get(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> f\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'https://api.contactship.ai/v1/thread/\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">thread_id\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> headers\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'x-api-key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'your-api-key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\">print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(response.json())\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"Example Response","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"23\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"thr-b2c3d4e5-f6a7-8901-bcde-f12345678901\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"channel_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"chn_a1b2c3d4e5f6g7h8i9j0k1l2\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"channel_type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"WABA\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"contact_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"c1d2e3f4-a5b6-7890-cdef-123456789012\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"organization_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"org-f1e2d3c4-b5a6-7890-1234-567890abcdef\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"open\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"assignee\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"assignee_type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"created_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-04-06T15:00:00Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"updated_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-04-06T15:05:00Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"referral\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"source_type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ad\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"source_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"120212345678900123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"source_url\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://fb.me/2AbCdEfGh\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"ctwa_clid\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ARAkLkA8rmlFeiCktEJQ-QTwRiyYHAFDLMNDBH0CD3qpjd0HR4irJ6LEkR7JwFF4XvnO2E4Nx0-eM-GABDLOPaOdRMv-_zfUQ2a\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"headline\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2x1 pizzas every Tuesday\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"body\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Order on WhatsApp and get the second pizza free.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"media_type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"image\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"image_url\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://scontent.xx.fbcdn.net/v/t45.1600-4/example.jpg?oe=6801A2B3\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"welcome_message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"text\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Hi! I want the 2x1 promo\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Get Thread","path":"/v1/thread/{threadId}","method":"get","request":{"security":[],"parameters":{"query":{},"header":{"x-api-key":{"schema":[{"type":"string","description":"Your API key for authentication.","required":true}]}},"cookie":{},"path":{"threadId":{"schema":[{"type":"string","description":"The UUID of the thread to retrieve.","required":true}]}}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"id":[{"type":"string","description":"Unique identifier of the thread (UUID)."}],"channel_id":[{"type":"string","description":"UUID of the channel this thread belongs to."}],"channel_type":[{"type":"string","description":"Type of the channel (e.g. `WABA` , `INSTAGRAM` )."}],"contact_id":[{"type":"string","description":"UUID of the contact in this thread."}],"organization_id":[{"type":"string","description":"UUID of the organization that owns this thread."}],"status":[{"type":"string","description":"Thread status (e.g. `open` , `closed` )."}],"assignee":[{"type":"string","description":"UUID of the user or agent currently assigned to this thread."}],"assignee_type":[{"type":"string","description":"Type of the assignee: `user` or `agent` ."}],"created_at":[{"type":"string","description":"Timestamp when the thread was created (ISO 8601)."}],"updated_at":[{"type":"string","description":"Timestamp of the last update (ISO 8601)."}],"referral":[{"type":"object","properties":{"source_type":[{"type":"string","description":"What the contact clicked: `ad` , `post` or `page` ."}],"source_id":[{"type":"string","description":"Meta ID of the ad or post. For ads, this is the ad ID in Ads Manager."}],"source_url":[{"type":"string","description":"Link to the ad or post on Facebook or Instagram."}],"ctwa_clid":[{"type":"string","description":"Click ID of the Click-to-WhatsApp ad. Use it with the Meta Conversions API to attribute a lead or a purchase to the ad (see below). Meta omits it in some cases, such as ads shown in WhatsApp Status."}],"headline":[{"type":"string","description":"Ad or post headline."}],"body":[{"type":"string","description":"Ad or post text."}],"media_type":[{"type":"string","description":"Type of media in the ad: `image` or `video` ."}],"image_url":[{"type":"string","description":"Image of the ad, when `media_type` is `image` ."}],"video_url":[{"type":"string","description":"Link to the video of the ad, when `media_type` is `video` ."}],"thumbnail_url":[{"type":"string","description":"Thumbnail of the video, when `media_type` is `video` ."}],"welcome_message":[{"type":"object","properties":{},"description":"Pre-filled message the ad suggested to the contact, as `{ \"text\": \"...\" }` ."}],"ref":[{"type":"string","description":"Custom `ref` parameter of the link, when the ad or the link set one."}]},"description":"Where the conversation came from, as Meta reported it in the contact’s first message. Present when someone wrote from a Click-to-WhatsApp ad, a post or a page; `null` for organic conversations. Fields Meta did not send are left out, so check each one before using it."}]}}],"examples":{"example":{"value":{"id":"\u003cstring>","channel_id":"\u003cstring>","channel_type":"\u003cstring>","contact_id":"\u003cstring>","organization_id":"\u003cstring>","status":"\u003cstring>","assignee":"\u003cstring>","assignee_type":"\u003cstring>","created_at":"\u003cstring>","updated_at":"\u003cstring>","referral":{"source_type":"\u003cstring>","source_id":"\u003cstring>","source_url":"\u003cstring>","ctwa_clid":"\u003cstring>","headline":"\u003cstring>","body":"\u003cstring>","media_type":"\u003cstring>","image_url":"\u003cstring>","video_url":"\u003cstring>","thumbnail_url":"\u003cstring>","welcome_message":{},"ref":"\u003cstring>"}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"contactship","siteName":"ContactShip Docs","title":"Get Thread - ContactShip Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"es":{"href":"/api-reference/endpoint/get-thread","matchLevel":0},"en":{"href":"/api-reference/endpoint/get-thread","matchLevel":0}}},"lastModified":"2026-11-12T20:45:26.087Z","originalFileLocation":"api-reference/endpoint/get-thread.mdx","locale":"es"},"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=\"Retrieve a conversation thread by its ID\">\u003cmeta data-mint-head name=\"application-name\" content=\"ContactShip Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Thread - ContactShip Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a conversation thread by its ID\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ContactShip Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.contactship.ai/api-reference/endpoint/get-thread\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://contactship.mintlify.site/_mintlify/api/og/v2?division=Canales+y+conversaciones\u0026amp;title=Get+Thread\u0026amp;description=Retrieve+a+conversation+thread+by+its+ID\u0026amp;theme=a06d13b3f4cf8a7c17fe2657\u0026amp;signature=a41f80a3c915aad083af1aee6e4cc002e4f3e5a5197a0e6e614f1e177482d82d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Thread - ContactShip Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a conversation thread by its ID\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://contactship.mintlify.site/_mintlify/api/og/v2?division=Canales+y+conversaciones\u0026amp;title=Get+Thread\u0026amp;description=Retrieve+a+conversation+thread+by+its+ID\u0026amp;theme=a06d13b3f4cf8a7c17fe2657\u0026amp;signature=a41f80a3c915aad083af1aee6e4cc002e4f3e5a5197a0e6e614f1e177482d82d\">\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/contactship/t9ds7rwKwjlbXW3P/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ContactShip Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0252ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.contactship.ai/api-reference/endpoint/get-thread\">\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/get-thread.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.contactship.ai/#organization\",\"name\":\"ContactShip Docs\",\"url\":\"https://docs.contactship.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/contactship/XJKLcqzvszyHAh2b/logo/Isologotipo.png?fit=max\u0026auto=format\u0026n=XJKLcqzvszyHAh2b\u0026q=85\u0026s=1100afd12fc8debe15faade6766a53c7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.contactship.ai#website\",\"name\":\"ContactShip Docs\",\"url\":\"https://docs.contactship.ai\",\"publisher\":{\"@id\":\"https://docs.contactship.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/get-thread#webpage\",\"url\":\"https://docs.contactship.ai/api-reference/endpoint/get-thread\",\"name\":\"Get Thread\",\"description\":\"Retrieve a conversation thread by its ID\",\"dateModified\":\"2026-11-12T20:45:26.087Z\",\"isPartOf\":{\"@id\":\"https://docs.contactship.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/get-thread#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/get-thread#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Canales y conversaciones\",\"item\":\"https://docs.contactship.ai/api-reference/endpoint/get-channels\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Thread\",\"item\":\"https://docs.contactship.ai/api-reference/endpoint/get-thread\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/get-thread#apireference\",\"headline\":\"Get Thread\",\"name\":\"Get Thread\",\"description\":\"Retrieve a conversation thread by its ID\",\"url\":\"https://docs.contactship.ai/api-reference/endpoint/get-thread\",\"mainEntityOfPage\":{\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/get-thread#webpage\"},\"dateModified\":\"2026-11-12T20:45:26.087Z\",\"publisher\":{\"@id\":\"https://docs.contactship.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.contactship.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ContactShip Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ContactShip Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/get-thread.md","siteName":"ContactShip Docs","nav":{"global":null,"languages":[{"language":"es","default":true,"tabs":[{"tab":"Documentación","pages":[{"title":"Documentación","href":"/es/comenzar/que-es-contactship"}]},{"tab":"Casos de uso","pages":[{"title":"Casos de uso","href":"/es/casos-de-uso"}]},{"tab":"API Reference","groups":[{"group":"Documentación API","pages":[{"title":"API Introduction","href":"/api-reference/introduction"},{"title":"Rate Limits and Retries","href":"/api-reference/rate-limits"},{"title":"Call webhook payload","href":"/api-reference/webhooks"},{"title":"Inbound context webhook","href":"/api-reference/inbound-webhook"},{"title":"Follow-up closure webhook","href":"/api-reference/follow-up-webhook"},{"title":"HTTP tool execution","href":"/api-reference/tool-execution"}]},{"group":"Voz","pages":[{"title":"Make AI Phone Call","api":"POST /v1/calls/single-phone-call","href":"/api-reference/endpoint/make-ai-phone-call"},{"title":"Call a Contact","api":"POST /v1/calls/single-contact-call","href":"/api-reference/endpoint/make-contact-call"}]},{"group":"WhatsApp (WABA)","pages":[{"title":"Send WhatsApp Message","api":"POST /v1/waba/send","href":"/api-reference/endpoint/waba-send-message"},{"title":"Send WhatsApp Template","api":"POST /v1/waba/send-template","href":"/api-reference/endpoint/waba-send-template"},{"title":"Send WhatsApp Media","api":"POST /v1/waba/send-media","href":"/api-reference/endpoint/waba-send-media"},{"title":"Send WhatsApp Location","api":"POST /v1/waba/send-location","href":"/api-reference/endpoint/waba-send-location"},{"title":"Get WhatsApp Templates","api":"GET /v1/waba/templates","href":"/api-reference/endpoint/waba-get-templates"}]},{"group":"Canales y conversaciones","pages":[{"title":"List Channels","api":"GET /v1/channels","href":"/api-reference/endpoint/get-channels"},{"title":"List Conversations","api":"GET /v1/conversations","description":"List the WhatsApp conversations of a channel that started in a date range","href":"/api-reference/endpoint/list-conversations"},{"title":"Get Thread","api":"GET /v1/thread/{threadId}","href":"/api-reference/endpoint/get-thread"},{"title":"List Thread Messages","api":"GET /v1/thread/{threadId}/messages","description":"Retrieve the messages of a thread, one page at a time","href":"/api-reference/endpoint/get-thread-messages"},{"title":"Update Thread","api":"PUT /v1/thread/{threadId}","href":"/api-reference/endpoint/update-thread"},{"title":"Get Message","api":"GET /v1/messages/{messageId}","href":"/api-reference/endpoint/get-message"}]},{"group":"Organización","pages":[{"title":"Get Credits","api":"GET /v1/credits","href":"/api-reference/endpoint/get-credits"}]},{"group":"Agentes","pages":[{"title":"Create Agent","api":"POST /v1/agents","href":"/api-reference/endpoint/create-agent"},{"title":"Get Agent","api":"GET /v1/agents/{agentId}","href":"/api-reference/endpoint/get-agent"},{"title":"List Agents","api":"GET /v1/agents","href":"/api-reference/endpoint/list-agents"},{"title":"Update Agent","api":"PUT /v1/agents/{agentId}","href":"/api-reference/endpoint/update-agent"},{"title":"Delete Agent","api":"DELETE /v1/agents/{agentId}","href":"/api-reference/endpoint/delete-agent"},{"title":"List Voices","api":"GET /v1/agents/voices","href":"/api-reference/endpoint/list-voices"}]},{"group":"Contactos","pages":[{"title":"Get Contacts","api":"GET /v1/contacts","href":"/api-reference/endpoint/get-contacts"},{"title":"Create Contact","api":"POST /v1/contacts","href":"/api-reference/endpoint/create-contact"},{"title":"Get Contact by Identifier","api":"GET /v1/contacts/{identifier}","href":"/api-reference/endpoint/get-contact-by-identifier"},{"title":"Get Contact Call History","api":"GET /v1/contacts/{contactId}/call-history","href":"/api-reference/endpoint/get-contact-call-history"},{"title":"Find Call History by Phone Number","href":"/api-reference/endpoint/get-contact-call-history-by-phone"},{"title":"Update Contact","api":"PATCH /v1/contacts/{contactId}","href":"/api-reference/endpoint/update-contact"},{"title":"Delete Contact","api":"DELETE /v1/contacts/{contactId}","href":"/api-reference/endpoint/delete-contact"},{"title":"Get Contact Comments","api":"GET /v1/contacts/{contactId}/comments","href":"/api-reference/endpoint/get-contact-comments"},{"title":"Create Contact Comment","api":"POST /v1/comments","href":"/api-reference/endpoint/create-comment"},{"title":"Get Contact Tags","api":"GET /v1/contacts/{contactId}/tags","href":"/api-reference/endpoint/get-contact-tags"},{"title":"Add Tag to Contact","api":"POST /v1/contacts/{contactId}/tags/{tagId}","href":"/api-reference/endpoint/add-contact-tag"},{"title":"Remove Tag from Contact","api":"DELETE /v1/contacts/{contactId}/tags/{tagId}","href":"/api-reference/endpoint/remove-contact-tag"}]},{"group":"Eventos","pages":[{"title":"Send Events","api":"POST /v1/events","href":"/api-reference/endpoint/send-events"},{"title":"Identify a Session","api":"POST /v1/identify","href":"/api-reference/endpoint/identify"}]},{"group":"Etiquetas","pages":[{"title":"List Tags","api":"GET /v1/tags","href":"/api-reference/endpoint/list-tags"},{"title":"Create Tag","api":"POST /v1/tags","href":"/api-reference/endpoint/create-tag"},{"title":"Update Tag","api":"PATCH /v1/tags/{tagId}","href":"/api-reference/endpoint/update-tag"},{"title":"Delete Tag","api":"DELETE /v1/tags/{tagId}","href":"/api-reference/endpoint/delete-tag"}]},{"group":"Llamadas","pages":[{"title":"List Calls","api":"GET /v1/calls","href":"/api-reference/endpoint/list-calls"},{"title":"Get Call","api":"GET /v1/calls/{callId}","href":"/api-reference/endpoint/get-call"},{"title":"Get Call Status","api":"GET /v1/calls/{callId}/status","href":"/api-reference/endpoint/get-call-status"},{"title":"Stop Call","api":"POST /v1/calls/single-phone-call/{callId}/stop","href":"/api-reference/endpoint/stop-call"}]},{"group":"Tareas","pages":[{"title":"List Tasks","api":"GET /v1/tasks","href":"/api-reference/endpoint/list-tasks"},{"title":"Get Task","api":"GET /v1/tasks/{id}","href":"/api-reference/endpoint/get-task"},{"title":"Create Task","api":"POST /v1/tasks","href":"/api-reference/endpoint/create-task"}]},{"group":"Números de teléfono","pages":[{"title":"List Phone Numbers","api":"GET /v1/phone-numbers","href":"/api-reference/endpoint/get-phone-numbers"}]}]}]},{"language":"en","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/en/get-started/what-is-contactship"}]},{"tab":"Use cases","pages":[{"title":"Use cases","href":"/en/use-cases"}]},{"tab":"API Reference","groups":[{"group":"API documentation","pages":[{"title":"API Introduction","href":"/api-reference/introduction"},{"title":"Rate Limits and Retries","href":"/api-reference/rate-limits"},{"title":"Call webhook payload","href":"/api-reference/webhooks"},{"title":"Inbound context webhook","href":"/api-reference/inbound-webhook"},{"title":"Follow-up closure webhook","href":"/api-reference/follow-up-webhook"},{"title":"HTTP tool execution","href":"/api-reference/tool-execution"}]},{"group":"Voice","pages":[{"title":"Make AI Phone Call","api":"POST /v1/calls/single-phone-call","href":"/api-reference/endpoint/make-ai-phone-call"},{"title":"Call a Contact","api":"POST /v1/calls/single-contact-call","href":"/api-reference/endpoint/make-contact-call"}]},{"group":"WhatsApp (WABA)","pages":[{"title":"Send WhatsApp Message","api":"POST /v1/waba/send","href":"/api-reference/endpoint/waba-send-message"},{"title":"Send WhatsApp Template","api":"POST /v1/waba/send-template","href":"/api-reference/endpoint/waba-send-template"},{"title":"Send WhatsApp Media","api":"POST /v1/waba/send-media","href":"/api-reference/endpoint/waba-send-media"},{"title":"Send WhatsApp Location","api":"POST /v1/waba/send-location","href":"/api-reference/endpoint/waba-send-location"},{"title":"Get WhatsApp Templates","api":"GET /v1/waba/templates","href":"/api-reference/endpoint/waba-get-templates"}]},{"group":"Channels and threads","pages":[{"title":"List Channels","api":"GET /v1/channels","href":"/api-reference/endpoint/get-channels"},{"title":"List Conversations","api":"GET /v1/conversations","description":"List the WhatsApp conversations of a channel that started in a date range","href":"/api-reference/endpoint/list-conversations"},{"title":"Get Thread","api":"GET /v1/thread/{threadId}","href":"/api-reference/endpoint/get-thread"},{"title":"List Thread Messages","api":"GET /v1/thread/{threadId}/messages","description":"Retrieve the messages of a thread, one page at a time","href":"/api-reference/endpoint/get-thread-messages"},{"title":"Update Thread","api":"PUT /v1/thread/{threadId}","href":"/api-reference/endpoint/update-thread"},{"title":"Get Message","api":"GET /v1/messages/{messageId}","href":"/api-reference/endpoint/get-message"}]},{"group":"Organization","pages":[{"title":"Get Credits","api":"GET /v1/credits","href":"/api-reference/endpoint/get-credits"}]},{"group":"Agents","pages":[{"title":"Create Agent","api":"POST /v1/agents","href":"/api-reference/endpoint/create-agent"},{"title":"Get Agent","api":"GET /v1/agents/{agentId}","href":"/api-reference/endpoint/get-agent"},{"title":"List Agents","api":"GET /v1/agents","href":"/api-reference/endpoint/list-agents"},{"title":"Update Agent","api":"PUT /v1/agents/{agentId}","href":"/api-reference/endpoint/update-agent"},{"title":"Delete Agent","api":"DELETE /v1/agents/{agentId}","href":"/api-reference/endpoint/delete-agent"},{"title":"List Voices","api":"GET /v1/agents/voices","href":"/api-reference/endpoint/list-voices"}]},{"group":"Contacts","pages":[{"title":"Get Contacts","api":"GET /v1/contacts","href":"/api-reference/endpoint/get-contacts"},{"title":"Create Contact","api":"POST /v1/contacts","href":"/api-reference/endpoint/create-contact"},{"title":"Get Contact by Identifier","api":"GET /v1/contacts/{identifier}","href":"/api-reference/endpoint/get-contact-by-identifier"},{"title":"Get Contact Call History","api":"GET /v1/contacts/{contactId}/call-history","href":"/api-reference/endpoint/get-contact-call-history"},{"title":"Find Call History by Phone Number","href":"/api-reference/endpoint/get-contact-call-history-by-phone"},{"title":"Update Contact","api":"PATCH /v1/contacts/{contactId}","href":"/api-reference/endpoint/update-contact"},{"title":"Delete Contact","api":"DELETE /v1/contacts/{contactId}","href":"/api-reference/endpoint/delete-contact"},{"title":"Get Contact Comments","api":"GET /v1/contacts/{contactId}/comments","href":"/api-reference/endpoint/get-contact-comments"},{"title":"Create Contact Comment","api":"POST /v1/comments","href":"/api-reference/endpoint/create-comment"},{"title":"Get Contact Tags","api":"GET /v1/contacts/{contactId}/tags","href":"/api-reference/endpoint/get-contact-tags"},{"title":"Add Tag to Contact","api":"POST /v1/contacts/{contactId}/tags/{tagId}","href":"/api-reference/endpoint/add-contact-tag"},{"title":"Remove Tag from Contact","api":"DELETE /v1/contacts/{contactId}/tags/{tagId}","href":"/api-reference/endpoint/remove-contact-tag"}]},{"group":"Events","pages":[{"title":"Send Events","api":"POST /v1/events","href":"/api-reference/endpoint/send-events"},{"title":"Identify a Session","api":"POST /v1/identify","href":"/api-reference/endpoint/identify"}]},{"group":"Tags","pages":[{"title":"List Tags","api":"GET /v1/tags","href":"/api-reference/endpoint/list-tags"},{"title":"Create Tag","api":"POST /v1/tags","href":"/api-reference/endpoint/create-tag"},{"title":"Update Tag","api":"PATCH /v1/tags/{tagId}","href":"/api-reference/endpoint/update-tag"},{"title":"Delete Tag","api":"DELETE /v1/tags/{tagId}","href":"/api-reference/endpoint/delete-tag"}]},{"group":"Calls","pages":[{"title":"List Calls","api":"GET /v1/calls","href":"/api-reference/endpoint/list-calls"},{"title":"Get Call","api":"GET /v1/calls/{callId}","href":"/api-reference/endpoint/get-call"},{"title":"Get Call Status","api":"GET /v1/calls/{callId}/status","href":"/api-reference/endpoint/get-call-status"},{"title":"Stop Call","api":"POST /v1/calls/single-phone-call/{callId}/stop","href":"/api-reference/endpoint/stop-call"}]},{"group":"Tasks","pages":[{"title":"List Tasks","api":"GET /v1/tasks","href":"/api-reference/endpoint/list-tasks"},{"title":"Get Task","api":"GET /v1/tasks/{id}","href":"/api-reference/endpoint/get-task"},{"title":"Create Task","api":"POST /v1/tasks","href":"/api-reference/endpoint/create-task"}]},{"group":"Phone numbers","pages":[{"title":"List Phone Numbers","api":"GET /v1/phone-numbers","href":"/api-reference/endpoint/get-phone-numbers"}]}]}]}]},"basePath":"","title":"Get Thread - ContactShip Docs","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js"]}