{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"LiveChatAI API Documentation","colors":{"primary":"#2188F3","light":"#2188F3","dark":"#2188F3"},"favicon":"https://mintcdn.com/livechatai/6nheG7kWh-i0JEuW/favicon.png?fit=max\u0026auto=format\u0026n=6nheG7kWh-i0JEuW\u0026q=85\u0026s=e4ffbe6df5d385f1ecc62efb834998fb","logo":{"light":"https://mintcdn.com/livechatai/6nheG7kWh-i0JEuW/logo/logo-black.png?fit=max\u0026auto=format\u0026n=6nheG7kWh-i0JEuW\u0026q=85\u0026s=54efa1885be0b382474f85983f649ef4","dark":"https://mintcdn.com/livechatai/6nheG7kWh-i0JEuW/logo/logo-white.png?fit=max\u0026auto=format\u0026n=6nheG7kWh-i0JEuW\u0026q=85\u0026s=f0ab6ba3ee34927f74e7a71689edf590"},"navbar":{"links":[{"label":"Support","href":"mailto:support@livechatai.com"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.livechatai.com"}},"footer":{"socials":{"discord":"https://discord.com/invite/X2WwkMVKt5","x":"https://x.com/LiveChatAI","linkedin":"https://www.linkedin.com/company/livechatai","youtube":"https://www.youtube.com/@livechataicom"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Documentation","href":"https://help.livechatai.com/","icon":"book-open-cover"},{"anchor":"Community","href":"https://discord.com/invite/X2WwkMVKt5","icon":"discord"},{"anchor":"Blog","href":"https://livechatai.com/blog","icon":"newspaper"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"livechatai","hasAudioNarration":false,"actualSubdomain":"livechatai","customDomains":["api.livechatai.com"],"gitSource":{"type":"github","owner":"popupsmartdev","repo":"live-chat-ai","deployBranch":"main","contentDirectory":"apps/api-doc","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a9ebf07f9357daf08fc2d49","collectionId":"6b1e39cf-0f64-446e-a206-9dcbac560003","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a9ebf07f9357daf08fc2d49"},"entitlements":{},"buildId":"6a9ebf07f9357daf08fc2d49","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"API Reference v2","count":43},{"language":"default","tag":"API Reference - DEPRECATED (1 Aug 2025)","count":16},{"language":"default","tag":"Conversations","count":9},{"language":"default","tag":"Translations","count":8},{"language":"default","tag":"Chatbot ","count":8},{"language":"default","tag":"Analytics","count":7},{"language":"default","tag":"Data Sources","count":7},{"language":"default","tag":"Data Source ","count":7},{"language":"default","tag":"Agents","count":4},{"language":"default","tag":"Contacts","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference-v2/contacts/retrieve","slug":"/api-reference-v2/contacts/retrieve","pageMetadata":{"openapi":"get /api/v2/contacts/{contactId}","title":"Retrieve a contact","description":"Retrieve detailed information about a specific contact, including their attributes and conversation history.","href":"/api-reference-v2/contacts/retrieve"},"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 detailed information about a specific contact, including their attributes and conversation history.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"get /api/v2/contacts/{contactId}","title":"Retrieve a contact","description":"Retrieve detailed information about a specific contact, including their attributes and conversation history.","href":"/api-reference-v2/contacts/retrieve"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"security":["d9c48798-3bf3-4465-89e7-36ce1fdad0a2"],"tags":["Contacts"],"description":"Retrieve detailed information about a specific contact, including their attributes and conversation history.","summary":"Retrieve a contact","parameters":["4450cc0b-81c6-47ea-9245-a1a0aaccdec6"],"responses":{"200":"4a165803-aefa-4ffa-a3a6-559881618d06","401":"1e1eeae5-f73c-4c1b-a49c-e306ac62e1a1","404":"6bbd45a6-2125-4ab3-b465-0a1b1a226a5d","500":"bcbb7374-3b26-4391-8d1b-1ed6bd5f1283"},"method":"get","type":"path","servers":["b1b83d82-bae1-4dc7-aea6-2871c4c5ab9e"],"path":"/api/v2/contacts/{contactId}","baseUrlOptions":["https://app.livechatai.com"],"title":"Retrieve a contact","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"4450cc0b-81c6-47ea-9245-a1a0aaccdec6":{"in":"path","name":"contactId","schema":{"type":"string","example":"contact_1234567890","isRequired":true,"description":"Unique identifier of the contact","uniqueKey":"","typeLabel":"string"},"required":true,"description":"Unique identifier of the contact"}},"responses":{"4a165803-aefa-4ffa-a3a6-559881618d06":{"description":"Successfully retrieved contact details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"contact_1234567890","uniqueKey":"id","typeLabel":"string"},"chatSource":{"oneOf":[{"type":"string","example":"website","uniqueKey":"chatSource.oneOf.0","typeLabel":"string"},{"type":"null","example":"website","uniqueKey":"chatSource.oneOf.1","typeLabel":"null"}],"uniqueKey":"chatSource","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","example":"john@example.com","uniqueKey":"email.oneOf.0","typeLabel":"string"},{"type":"null","example":"john@example.com","uniqueKey":"email.oneOf.1","typeLabel":"null"}],"uniqueKey":"email","typeLabel":"string | null"},"agentId":{"type":"string","example":"clx1234567890abcdef","uniqueKey":"agentId","typeLabel":"string"},"distinctId":{"oneOf":[{"type":"string","example":"user_12345","uniqueKey":"distinctId.oneOf.0","typeLabel":"string"},{"type":"null","example":"user_12345","uniqueKey":"distinctId.oneOf.1","typeLabel":"null"}],"uniqueKey":"distinctId","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","example":"John Doe","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","example":"John Doe","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","example":"+1234567890","uniqueKey":"phone.oneOf.0","typeLabel":"string"},{"type":"null","example":"+1234567890","uniqueKey":"phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"phone","typeLabel":"string | null"},"threadId":{"oneOf":[{"type":"string","example":"thread_12345","uniqueKey":"threadId.oneOf.0","typeLabel":"string"},{"type":"null","example":"thread_12345","uniqueKey":"threadId.oneOf.1","typeLabel":"null"}],"uniqueKey":"threadId","typeLabel":"string | null"},"ip":{"oneOf":[{"type":"string","example":"192.168.1.1","uniqueKey":"ip.oneOf.0","typeLabel":"string"},{"type":"null","example":"192.168.1.1","uniqueKey":"ip.oneOf.1","typeLabel":"null"}],"uniqueKey":"ip","typeLabel":"string | null"},"country":{"oneOf":[{"type":"string","example":"US","uniqueKey":"country.oneOf.0","typeLabel":"string"},{"type":"null","example":"US","uniqueKey":"country.oneOf.1","typeLabel":"null"}],"uniqueKey":"country","typeLabel":"string | null"},"attributes":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","example":"planType","uniqueKey":"attributes.items.[INDEX].key","typeLabel":"string"},"value":{"type":"string","example":"premium","uniqueKey":"attributes.items.[INDEX].value","typeLabel":"string"}},"uniqueKey":"attributes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"attributes","typeLabel":"object[]"},"createdAt":{"type":"string","format":"date-time","example":"2024-01-15T10:30:00Z","uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","example":"2024-01-20T14:45:00Z","uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"contact_1234567890","chatSource":"website","email":"john@example.com","agentId":"clx1234567890abcdef","distinctId":"user_12345","name":"John Doe","phone":"+1234567890","threadId":"thread_12345","ip":"192.168.1.1","country":"US","attributes":[{"key":"planType","value":"premium"}],"createdAt":"2024-01-15T10:30:00Z","updatedAt":"2024-01-20T14:45:00Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"1e1eeae5-f73c-4c1b-a49c-e306ac62e1a1":{"description":"Unauthorized access","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"6bbd45a6-2125-4ab3-b465-0a1b1a226a5d":{"description":"Contact not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"bcbb7374-3b26-4391-8d1b-1ed6bd5f1283":{"description":"An internal server error occurred.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"d9c48798-3bf3-4465-89e7-36ce1fdad0a2":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]}}},"servers":{"b1b83d82-bae1-4dc7-aea6-2871c4c5ab9e":{"url":"https://app.livechatai.com","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference-v2/openapi.json"},"subdomain":"livechatai","siteName":"LiveChatAI API Documentation","title":"Retrieve a contact - LiveChatAI API Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-26T10:53:50.301Z","originalFileLocation":"api-reference-v2/contacts/retrieve.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve detailed information about a specific contact, including their attributes and conversation history.\">\u003cmeta data-mint-head name=\"application-name\" content=\"LiveChatAI API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/livechatai/j9WQ7z5dvL5YK_MC/_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/livechatai/j9WQ7z5dvL5YK_MC/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/livechatai/j9WQ7z5dvL5YK_MC/_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/livechatai/j9WQ7z5dvL5YK_MC/_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/livechatai/j9WQ7z5dvL5YK_MC/_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/livechatai/j9WQ7z5dvL5YK_MC/_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/livechatai/j9WQ7z5dvL5YK_MC/_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/livechatai/j9WQ7z5dvL5YK_MC/_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/livechatai/j9WQ7z5dvL5YK_MC/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve a contact - LiveChatAI API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve detailed information about a specific contact, including their attributes and conversation history.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LiveChatAI API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api.livechatai.com/api-reference-v2/contacts/retrieve\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://livechatai.mintlify.site/_mintlify/api/og/v2?division=Contacts\u0026amp;title=Retrieve+a+contact\u0026amp;description=Retrieve+detailed+information+about+a+specific+contact%2C+including+their+attributes+and+conversation+history.\u0026amp;theme=44885a49d2661da5e474e315\u0026amp;signature=ad1f7643f5612a5d3fd92c054d865165d95119476078a26ddcff761c5b1ccd3b\">\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=\"Retrieve a contact - LiveChatAI API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve detailed information about a specific contact, including their attributes and conversation history.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://livechatai.mintlify.site/_mintlify/api/og/v2?division=Contacts\u0026amp;title=Retrieve+a+contact\u0026amp;description=Retrieve+detailed+information+about+a+specific+contact%2C+including+their+attributes+and+conversation+history.\u0026amp;theme=44885a49d2661da5e474e315\u0026amp;signature=ad1f7643f5612a5d3fd92c054d865165d95119476078a26ddcff761c5b1ccd3b\">\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/livechatai/j9WQ7z5dvL5YK_MC/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LiveChatAI API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2188F3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://api.livechatai.com/api-reference-v2/contacts/retrieve\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference-v2/contacts/retrieve.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://api.livechatai.com/#organization\",\"name\":\"LiveChatAI API Documentation\",\"url\":\"https://api.livechatai.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/livechatai/6nheG7kWh-i0JEuW/logo/logo-black.png?fit=max\u0026auto=format\u0026n=6nheG7kWh-i0JEuW\u0026q=85\u0026s=54efa1885be0b382474f85983f649ef4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://api.livechatai.com#website\",\"name\":\"LiveChatAI API Documentation\",\"url\":\"https://api.livechatai.com\",\"publisher\":{\"@id\":\"https://api.livechatai.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://api.livechatai.com/api-reference-v2/contacts/retrieve#webpage\",\"url\":\"https://api.livechatai.com/api-reference-v2/contacts/retrieve\",\"name\":\"Retrieve a contact\",\"description\":\"Retrieve detailed information about a specific contact, including their attributes and conversation history.\",\"dateModified\":\"2026-01-26T10:53:50.301Z\",\"isPartOf\":{\"@id\":\"https://api.livechatai.com#website\"},\"breadcrumb\":{\"@id\":\"https://api.livechatai.com/api-reference-v2/contacts/retrieve#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api.livechatai.com/api-reference-v2/contacts/retrieve#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Contacts\",\"item\":\"https://api.livechatai.com/api-reference-v2/contacts/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve a contact\",\"item\":\"https://api.livechatai.com/api-reference-v2/contacts/retrieve\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://api.livechatai.com/api-reference-v2/contacts/retrieve#apireference\",\"headline\":\"Retrieve a contact\",\"name\":\"Retrieve a contact\",\"description\":\"Retrieve detailed information about a specific contact, including their attributes and conversation history.\",\"url\":\"https://api.livechatai.com/api-reference-v2/contacts/retrieve\",\"mainEntityOfPage\":{\"@id\":\"https://api.livechatai.com/api-reference-v2/contacts/retrieve#webpage\"},\"dateModified\":\"2026-01-26T10:53:50.301Z\",\"publisher\":{\"@id\":\"https://api.livechatai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://api.livechatai.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LiveChatAI API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"LiveChatAI API Documentation","nav":{"global":{"anchors":[{"anchor":"Documentation","href":"https://help.livechatai.com/","icon":"book-open-cover"},{"anchor":"Community","href":"https://discord.com/invite/X2WwkMVKt5","icon":"discord"},{"anchor":"Blog","href":"https://livechatai.com/blog","icon":"newspaper"}]},"tabs":[{"tab":"API Reference v2","groups":[{"group":"API v2 Documentation","pages":[{"title":"Introduction","href":"/api-reference-v2/introduction"}]},{"group":"Agents","pages":[{"openapi":"post /api/v2/agents","title":"Create an agent","href":"/api-reference-v2/agents/create"},{"openapi":"get /api/v2/agents","title":"List agents","href":"/api-reference-v2/agents/list"},{"openapi":"get /api/v2/agents/{agentId}","title":"Retrieve an agent","href":"/api-reference-v2/agents/retrieve"},{"openapi":"delete /api/v2/agents/{agentId}","title":"Delete an agent","href":"/api-reference-v2/agents/delete"}]},{"group":"Conversations","pages":[{"openapi":"get /api/v2/conversations","title":"List conversations","href":"/api-reference-v2/conversations/list"},{"openapi":"get /api/v2/conversations/views","title":"List conversation views","href":"/api-reference-v2/conversations/list-views"},{"openapi":"post /api/v2/conversations/create","title":"Create a conversation","href":"/api-reference-v2/conversations/create"},{"openapi":"post /api/v2/conversations","title":"Send a message","href":"/api-reference-v2/conversations/send-message"},{"openapi":"get /api/v2/conversations/{conversationId}","title":"Retrieve a conversation","href":"/api-reference-v2/conversations/retrieve"},{"openapi":"post /api/v2/conversations/{conversationId}/reply","title":"Reply to a conversation","href":"/api-reference-v2/conversations/reply"},{"title":"Upload an attachment","openapi":"post /api/v2/conversations/{conversationId}/attachments/presign","href":"/api-reference-v2/conversations/attachment-presign"},{"openapi":"post /api/v2/conversations/{conversationId}/typing","title":"Send an \"agent is typing\" indicator","href":"/api-reference-v2/conversations/typing"},{"openapi":"post /api/v2/conversations/{conversationId}/end","title":"End a conversation","href":"/api-reference-v2/conversations/end"}]},{"group":"Contacts","pages":[{"openapi":"post /api/v2/contacts","title":"Create or update a contact","href":"/api-reference-v2/contacts/create"},{"openapi":"get /api/v2/contacts","title":"List contacts","href":"/api-reference-v2/contacts/list"},{"openapi":"get /api/v2/contacts/{contactId}/conversations","title":"List conversations for a contact","description":"List conversations for a specific contact with pagination and filtering options. Mirrors the response shape of `GET /api/v2/conversations`, scoped to a single contact.","href":"/api-reference-v2/contacts/list-conversations"},{"openapi":"get /api/v2/contacts/{contactId}","title":"Retrieve a contact","href":"/api-reference-v2/contacts/retrieve"}]},{"group":"Data Sources","pages":[{"openapi":"get /api/v2/data-sources","title":"List data sources","description":"List all data sources for an agent. This endpoint provides a unified view of all training data sources including websites, text, Q\u0026A pairs, and uploaded files. It supports pagination, filtering, and search to help manage large datasets efficiently.","href":"/api-reference-v2/data-sources/list"},{"openapi":"post /api/v2/data-sources/text","title":"Create a text data source","href":"/api-reference-v2/data-sources/create-text"},{"openapi":"post /api/v2/data-sources/url","title":"Create a URL data source","href":"/api-reference-v2/data-sources/create-url"},{"openapi":"post /api/v2/data-sources/qa","title":"Create a Q\u0026A data source","href":"/api-reference-v2/data-sources/create-qa"},{"openapi":"post /api/v2/data-sources/file","title":"Create a file data source","href":"/api-reference-v2/data-sources/create-file"},{"openapi":"put /api/v2/data-sources/qa","title":"Update a Q\u0026A data source","href":"/api-reference-v2/data-sources/update-qa"},{"openapi":"delete /api/v2/data-sources","title":"Delete data sources","href":"/api-reference-v2/data-sources/delete"}]},{"group":"Translations","pages":[{"openapi":"get /api/v2/chatbots/{chatbotId}/translations","title":"Get chatbot translations","href":"/api-reference-v2/translations/list"},{"openapi":"get /api/v2/chatbots/{chatbotId}/translations/languages","title":"List available languages","href":"/api-reference-v2/translations/list-languages"},{"openapi":"post /api/v2/chatbots/{chatbotId}/translations/languages","title":"Add a language","href":"/api-reference-v2/translations/add-language"},{"openapi":"delete /api/v2/chatbots/{chatbotId}/translations/languages/{language}","title":"Remove a language","href":"/api-reference-v2/translations/delete-language"},{"openapi":"put /api/v2/chatbots/{chatbotId}/translations/{language}","title":"Bulk update translations","href":"/api-reference-v2/translations/update-bulk"},{"openapi":"patch /api/v2/chatbots/{chatbotId}/translations/{language}/{key}","title":"Update a translation key","href":"/api-reference-v2/translations/update-key"},{"openapi":"delete /api/v2/chatbots/{chatbotId}/translations/{language}/{key}","title":"Reset a translation key","href":"/api-reference-v2/translations/delete-key"},{"openapi":"patch /api/v2/chatbots/{chatbotId}/translations/settings","title":"Update localization settings","href":"/api-reference-v2/translations/update-settings"}]},{"group":"AI Suggestions","pages":[{"openapi":"get /api/v2/ai-suggestions","title":"List AI Suggestions","href":"/api-reference-v2/ai-suggestions/list"},{"openapi":"get /api/v2/ai-suggestions/{suggestionId}","title":"Retrieve AI Suggestion","href":"/api-reference-v2/ai-suggestions/retrieve"},{"openapi":"delete /api/v2/ai-suggestions/{suggestionId}","title":"Delete AI Suggestion","href":"/api-reference-v2/ai-suggestions/delete"}]},{"group":"Analytics","pages":[{"openapi":"get /api/v2/analytics","title":"Get main analytics","href":"/api-reference-v2/analytics/main"},{"openapi":"get /api/v2/analytics/agent","title":"Get agent analytics","href":"/api-reference-v2/analytics/agent"},{"openapi":"get /api/v2/analytics/ai-functions","title":"Get AI function analytics","href":"/api-reference-v2/analytics/ai-functions"},{"openapi":"get /api/v2/analytics/csat","title":"Get CSAT analytics","href":"/api-reference-v2/analytics/csat"},{"openapi":"get /api/v2/analytics/sentiments","title":"Get sentiment analytics","href":"/api-reference-v2/analytics/sentiments"},{"openapi":"get /api/v2/analytics/resolutions","title":"Get resolution analytics","href":"/api-reference-v2/analytics/resolutions"},{"openapi":"get /api/v2/analytics/topics","title":"Get topics analytics","href":"/api-reference-v2/analytics/topics"}]}]},{"tab":"API Reference - DEPRECATED (1 Aug 2025)","pages":[{"title":"API Reference - DEPRECATED (1 Aug 2025)","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Retrieve a contact - LiveChatAI API Documentation","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Myd8dsju.js","utils-C2HkQgW0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-8rSppmTv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B6MjiCFm.js","snippetPresets-DwrSAONL.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-1-a5UQKQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C541m7wZ.js","shallow-CWELCZ77.js","getApiPlaygroundDisplay-CTo5Zn03.js","CodeSnippet-D--dzvnl.js","CodeSnippets-DM3cXEDh.js","Page-CxAy5y67.js","getPastedJson-C-VECgcL.js","icon-BPq2-Mg3.js","MethodPill-D9J5cUHd.js","DuplicateIcon-BqHaxUnD.js","createIcon-CIbcZHp9.js","DynamicMarkdown-BKiHAm_d.js","SectionHeading-DstQXt3H.js","axios-vUo_bRtp.js","Markdown-CpxgzsKA.js","clsx-C5EfhVm0.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CJ9Oly2E.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Mk6P3qvh.js"]}