HTTP Basic Authentication. Use your API Access Key ID as the username and your API Access Key Secret as the password. Generate keys in the CloudTalk Dashboard under Account -> Settings -> API Keys (https://dashboard.cloudtalk.io/menu/account/settings/API-keys).
The contact's name. null only for an older contact saved without one: contacts created through this API always have a name, and an update cannot clear it.
Time of the last change. It moves on changes made through this API, the Dashboard contact form and CSV import. Dashboard bulk edits, CRM list sync, and renaming or deleting a contact tag do not move it.
Link to the contact's page in the CloudTalk Dashboard. It carries no credentials: the person must be signed in to your company's Dashboard, and your company must have Contacts in its menu, otherwise the Dashboard opens their default page. Read-only.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CloudTalk Help Center","description":"CloudTalk developer documentation — REST API reference and integration guides.","colors":{"primary":"#0527FF","light":"#8495FF","dark":"#0420D5"},"logo":{"light":"https://mintcdn.com/cloudtalk/M_FX1uE099dO0_78/logo/light.svg?fit=max\u0026auto=format\u0026n=M_FX1uE099dO0_78\u0026q=85\u0026s=9efde0e0ef215d0b41a2f8f92056e144","dark":"https://mintcdn.com/cloudtalk/M_FX1uE099dO0_78/logo/dark.svg?fit=max\u0026auto=format\u0026n=M_FX1uE099dO0_78\u0026q=85\u0026s=4f13ec15ddcb5aaaac1005fe27b20494"},"favicon":"https://mintcdn.com/cloudtalk/M_FX1uE099dO0_78/favicon.svg?fit=max\u0026auto=format\u0026n=M_FX1uE099dO0_78\u0026q=85\u0026s=b8634fcc454e4f7d772d4c384046ec0b","api":{"examples":{"prefill":true,"autogenerate":true}},"background":{"color":{"light":"#F9FAFB","dark":"#1A1B1E"}},"navbar":{"links":[{"href":"https://support.cloudtalk.io/","label":"Support"}],"primary":{"type":"button","label":"Log in","href":"https://dashboard.cloudtalk.io/"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/cloudtalk.io","youtube":"https://www.youtube.com/channel/UCIVoouQBQ9u6ahSJJ7f5orQ","facebook":"https://www.facebook.com/CloudTalkCallCenter","instagram":"https://www.instagram.com/cloudtalk_io"},"links":[{"header":"Product","items":[{"label":"Pricing","href":"https://www.cloudtalk.io/pricing"},{"label":"AI Voice Agents","href":"https://www.cloudtalk.io/ai-voice-agents"},{"label":"AI Sales Dialer","href":"https://www.cloudtalk.io/dialer"},{"label":"AI Receptionist","href":"https://www.cloudtalk.io/ai-receptionist"},{"label":"Inbound Call Center","href":"https://www.cloudtalk.io/inbound-support-center"},{"label":"Outbound Call Center","href":"https://www.cloudtalk.io/outbound-sales"}]},{"header":"Support","items":[{"label":"Help Center","href":"https://help.cloudtalk.io/en"},{"label":"Status Page","href":"https://status.cloudtalk.io/"},{"label":"Contact Us","href":"https://www.cloudtalk.io/contact"},{"label":"Request a Free Trial","href":"https://www.cloudtalk.io/signup"}]},{"header":"Company","items":[{"label":"Our Story","href":"https://www.cloudtalk.io/our-story"},{"label":"Careers","href":"https://www.cloudtalk.io/careers"},{"label":"Security","href":"https://www.cloudtalk.io/security"},{"label":"Trust Center","href":"https://trust.cloudtalk.io/"},{"label":"Brand Assets","href":"https://www.cloudtalk.io/brand-assets"}]},{"header":"Legal","items":[{"label":"Terms \u0026 Conditions","href":"https://www.cloudtalk.io/terms-and-conditions"},{"label":"Privacy Notice","href":"https://www.cloudtalk.io/privacy-notice"}]}]},"fonts":{"family":"Public Sans"},"styling":{"codeblocks":"system","latex":true},"integrations":{"ga4":{"measurementId":"G-FMQKD83J1Q"}},"contextual":{"options":["copy","view","mcp","cursor","vscode","chatgpt","claude","perplexity"],"display":"header"},"markdown":{"schema":false},"navigation":{"languages":[{"language":"en","href":"en"},{"language":"de","href":"de"},{"language":"es","href":"es"},{"language":"fr","href":"fr"},{"language":"nl","href":"nl"},{"language":"pt","href":"pt"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloudtalk","hasAudioNarration":false,"actualSubdomain":"cloudtalk","customDomains":["help.cloudtalk.io"],"gitSource":{"type":"github","owner":"cloudtalk-io","repo":"developer-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6aec9ec03744ce14d084b34a","collectionId":"6276a432-b3f6-4876-8b11-b8bc3cb019f0","liveDeploymentHistoryId":"6aec9ec03744ce14d084b34a","schemaVersion":"v3"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aec9ec03744ce14d084b34a","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"en","tag":"Help Center","count":454},{"language":"de","tag":"Hilfecenter","count":453},{"language":"es","tag":"Centro de ayuda","count":453},{"language":"fr","tag":"Centre d'aide","count":453},{"language":"nl","tag":"Helpcentrum","count":453},{"language":"pt","tag":"Centro de ajuda","count":453},{"language":"en","tag":"API","count":140},{"language":"en","tag":"API Reference","count":130},{"language":"en","tag":"Integrations","count":97},{"language":"de","tag":"Integrationen","count":97},{"language":"es","tag":"Integraciones","count":97},{"language":"fr","tag":"Intégrations","count":97},{"language":"nl","tag":"Integraties","count":97},{"language":"pt","tag":"Integrações","count":97},{"language":"en","tag":"Dashboard","count":90},{"language":"de","tag":"Dashboard","count":90},{"language":"es","tag":"Dashboard","count":90},{"language":"fr","tag":"Dashboard","count":90},{"language":"nl","tag":"Dashboard","count":90},{"language":"pt","tag":"Dashboard","count":90},{"language":"en","tag":"Numbers \u0026 porting","count":67},{"language":"de","tag":"Nummern \u0026 Portierung","count":67},{"language":"es","tag":"Números y portabilidad","count":67},{"language":"fr","tag":"Numéros et portabilité","count":67},{"language":"nl","tag":"Nummers \u0026 portering","count":67},{"language":"pt","tag":"Números e portabilidade","count":67},{"language":"en","tag":"CRM","count":51},{"language":"de","tag":"CRM","count":51},{"language":"es","tag":"CRM","count":51},{"language":"fr","tag":"CRM","count":51},{"language":"nl","tag":"CRM","count":51},{"language":"pt","tag":"CRM","count":51},{"language":"en","tag":"AI","count":43},{"language":"de","tag":"KI","count":42},{"language":"es","tag":"IA","count":42},{"language":"fr","tag":"IA","count":42},{"language":"nl","tag":"AI","count":42},{"language":"pt","tag":"IA","count":42},{"language":"en","tag":"CloudTalk Phone \u0026 Go","count":40},{"language":"en","tag":"Porting by country","count":40},{"language":"de","tag":"CloudTalk Phone \u0026 Go","count":40},{"language":"de","tag":"Portierung nach Land","count":40},{"language":"es","tag":"CloudTalk Phone y Go","count":40},{"language":"es","tag":"Portabilidad por país","count":40},{"language":"fr","tag":"CloudTalk Phone et Go","count":40},{"language":"fr","tag":"Portabilité par pays","count":40},{"language":"nl","tag":"CloudTalk Phone \u0026 Go","count":40},{"language":"nl","tag":"Portering per land","count":40},{"language":"pt","tag":"CloudTalk Phone e Go","count":40},{"language":"pt","tag":"Portabilidade por país","count":40},{"language":"de","tag":"Erste Schritte","count":33},{"language":"es","tag":"Primeros pasos","count":33},{"language":"fr","tag":"Premiers pas","count":33},{"language":"nl","tag":"Aan de slag","count":33},{"language":"pt","tag":"Primeiros passos","count":33},{"language":"de","tag":"Abrechnung \u0026 Abonnement","count":29},{"language":"es","tag":"Facturación y suscripción","count":29},{"language":"fr","tag":"Facturation et abonnement","count":29},{"language":"nl","tag":"Facturering \u0026 abonnement","count":29},{"language":"pt","tag":"Faturação e subscrição","count":29}],"searchSettings":{"maxResults":8,"showContentSnippets":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"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}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"html:not(.dark) #navbar>div:first-child{background:#f5f5f5}#navbar img.nav-logo{height:1.3125rem}#navbar a[href^=\"https://dashboard.cloudtalk.io\"],#navbar a[href^=\"https://dashboard.cloudtalk.io\"] *{color:#ffffff!important}#navbar a[href^=\"https://dashboard.cloudtalk.io\"]{background:#0420d5;height:2.25rem;padding:0 0.875rem;border-radius:0.625rem;font-weight:600}#navbar a[href^=\"https://dashboard.cloudtalk.io\"]:hover{background:#031aaa;color:#ffffff!important}.dark #navbar a[href^=\"https://dashboard.cloudtalk.io\"]{background:#0527ff}.dark #navbar a[href^=\"https://dashboard.cloudtalk.io\"]:hover{background:#304cff}#navbar a[href^=\"https://support.cloudtalk.io\"]{background:transparent;color:#181d27!important;box-shadow:inset 0 0 0 1px #d5d7da;height:2.25rem;padding:0 0.875rem;border-radius:0.625rem;font-weight:600}#navbar a[href^=\"https://support.cloudtalk.io\"]:hover{background:#e9eaeb;color:#181d27!important}.dark #navbar a[href^=\"https://support.cloudtalk.io\"]{background:transparent;color:#ececed!important;box-shadow:inset 0 0 0 1px #373a41}.dark #navbar a[href^=\"https://support.cloudtalk.io\"]:hover{background:#2b303b;color:#ececed!important}html:not(.dark) #assistant-entry{background:#ffffff}#navbar nav[aria-label=\"Main\"]>ul>li:not(:last-child){margin-inline-end:0.75rem}#sidebar-content>div.border-t{display:none}nav#sidebar-content{border-right:0}@media (min-width: 1024px){main#content-container{padding-left:3rem!important}}#sidebar-content>button{display:none}"}],"page":{"pagePath":"api-reference/contacts/get-a-contact","slug":"/api-reference/contacts/get-a-contact","pageMetadata":{"title":"Get a contact","description":"Returns one contact with every number, email, tag and custom field. Integration tags are not listed in `tags`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contacts/{contactId}","href":"/api-reference/contacts/get-a-contact","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns one contact with every number, email, tag and custom field. Integration tags are not listed in \", _jsx(_components.code, {\n children: \"tags\"\n }), \".\"]\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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Get a contact","description":"Returns one contact with every number, email, tag and custom field. Integration tags are not listed in `tags`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contacts/{contactId}","href":"/api-reference/contacts/get-a-contact","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloudtalk/3405988015c78c5c/theme-toggle.js"],"openApiReferenceData":{"operation":{"servers":["13d0ed27-3ba1-4f25-b7ae-4ef24d1bfb6a"],"tags":["Contacts"],"summary":"Get a contact","description":"Returns one contact with every number, email, tag and custom field. Integration tags are not listed in `tags`.","operationId":"public-v1-get-contact","parameters":["35259989-e5d9-4659-967c-ad4887303a7b"],"responses":{"200":"7d476ca4-842d-4605-a0aa-a0f4243281cd","400":"85b5c23f-e645-455f-aeaa-72a0dbe9ec58","401":"d7fc4dee-f7dd-4756-90ef-961f90e89521","404":"a8dfb5e4-ad5e-42a8-b104-a11ea4af4c80","409":"5f2a43c5-c6ae-4551-bde7-edc64e307dbb","429":"7eeabb7a-9b7b-49ae-9a59-2b996ef3bd64","500":"3295acd0-ddf3-4a80-8874-2fbdfd74918b","502":"49e174d5-5f0b-4b64-8b71-1105b881afce"},"method":"get","type":"path","security":["709dbfc2-8125-4794-9c14-16448a97d046"],"path":"/contacts/{contactId}","baseUrlOptions":["https://api.cloudtalk.io/v1"],"title":"Get a contact","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"35259989-e5d9-4659-967c-ad4887303a7b":{"name":"contactId","in":"path","required":true,"description":"The contact id.","schema":{"type":"string","example":"44210","isRequired":true,"description":"The contact id.","uniqueKey":"","typeLabel":"string"}}},"responses":{"7d476ca4-842d-4605-a0aa-a0f4243281cd":{"description":"The contact.","content":{"application/json":{"schema":{"type":"object","description":"A contact or lead, with every number, email, tag and custom field.","required":["id","type","name","title","company","industry","website","address","city","state","zip","country","phones","emails","tags","customFields","favoriteUserId","source","createdAt","updatedAt","dashboardUrl"],"properties":{"id":{"type":"string","description":"Contact id.","example":"44210","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"type":{"type":"string","enum":["contact","lead"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","minLength":1,"maxLength":150,"example":"Jane Doe","description":"The contact's name. `null` only for an older contact saved without one: contacts created through this API always have a name, and an update cannot clear it.","isRequired":true,"uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":150,"example":"Jane Doe","description":"The contact's name. `null` only for an older contact saved without one: contacts created through this API always have a name, and an update cannot clear it.","isRequired":true,"uniqueKey":"name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"name","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","maxLength":255,"isRequired":true,"uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"isRequired":true,"uniqueKey":"title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"title","typeLabel":"string | null"},"company":{"oneOf":[{"type":"string","maxLength":100,"isRequired":true,"uniqueKey":"company.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":100,"isRequired":true,"uniqueKey":"company.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"company","typeLabel":"string | null"},"industry":{"oneOf":[{"type":"string","maxLength":100,"isRequired":true,"uniqueKey":"industry.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":100,"isRequired":true,"uniqueKey":"industry.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"industry","typeLabel":"string | null"},"website":{"oneOf":[{"type":"string","maxLength":100,"isRequired":true,"uniqueKey":"website.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":100,"isRequired":true,"uniqueKey":"website.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"website","typeLabel":"string | null"},"address":{"oneOf":[{"type":"string","maxLength":255,"isRequired":true,"uniqueKey":"address.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"isRequired":true,"uniqueKey":"address.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"address","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","maxLength":255,"isRequired":true,"uniqueKey":"city.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"isRequired":true,"uniqueKey":"city.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"city","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","maxLength":255,"isRequired":true,"uniqueKey":"state.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"isRequired":true,"uniqueKey":"state.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"state","typeLabel":"string | null"},"zip":{"oneOf":[{"type":"string","maxLength":15,"isRequired":true,"uniqueKey":"zip.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":15,"isRequired":true,"uniqueKey":"zip.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"zip","typeLabel":"string | null"},"country":{"oneOf":[{"type":"object","required":["code","name"],"properties":{"code":{"type":"string","description":"ISO 3166-1 alpha-2.","example":"US","isRequired":true,"uniqueKey":"country.oneOf.0.code","typeLabel":"string"},"name":{"type":"string","example":"United States","isRequired":true,"uniqueKey":"country.oneOf.0.name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"country.oneOf.0","typeLabel":"object"},{"type":"null","required":["code","name"],"properties":{"code":{"type":"string","description":"ISO 3166-1 alpha-2.","example":"US"},"name":{"type":"string","example":"United States"}},"isRequired":true,"uniqueKey":"country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"country","typeLabel":"object | null"},"phones":{"type":"array","items":{"type":"string","uniqueKey":"phones.items.[INDEX]","typeLabel":"string"},"description":"Every number on the contact, in E.164.","example":["+12025550143"],"isRequired":true,"uniqueKey":"phones","typeLabel":"string[]"},"emails":{"type":"array","items":{"type":"string","uniqueKey":"emails.items.[INDEX]","typeLabel":"string"},"description":"Every email on the contact.","example":["[email protected]"],"isRequired":true,"uniqueKey":"emails","typeLabel":"string[]"},"tags":{"type":"array","items":{"type":"object","required":["id","name","readOnly"],"properties":{"id":{"type":"string","example":"123","isRequired":true,"uniqueKey":"tags.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","example":"vip","isRequired":true,"uniqueKey":"tags.items.[INDEX].name","typeLabel":"string"},"readOnly":{"type":"boolean","description":"`true` for a tag this API cannot add, remove, rename or delete, such as a CRM list tag. See List contact tags.","isRequired":true,"uniqueKey":"tags.items.[INDEX].readOnly","typeLabel":"boolean"}},"uniqueKey":"tags.items.[INDEX]","typeLabel":"object"},"description":"The contact's contact tags. Integration tags are not listed.","isRequired":true,"uniqueKey":"tags","typeLabel":"object[]"},"customFields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"customFields.additionalProperties","typeLabel":"string"},"description":"Custom field values as strings, keyed by the field `name` from List contact fields.","example":{"Segment":"enterprise"},"isRequired":true,"uniqueKey":"customFields","typeLabel":"object"},"favoriteUserId":{"oneOf":[{"type":"string","description":"The user who owns the contact.","example":"7","isRequired":true,"uniqueKey":"favoriteUserId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The user who owns the contact.","example":"7","isRequired":true,"uniqueKey":"favoriteUserId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"favoriteUserId","typeLabel":"string | null"},"source":{"type":"string","description":"Where the contact came from. Contacts created through this API have `api`. Read-only.","example":"api","isRequired":true,"uniqueKey":"source","typeLabel":"string"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"Time of the last change. It moves on changes made through this API, the Dashboard contact form and CSV import. Dashboard bulk edits, CRM list sync, and renaming or deleting a contact tag do not move it.","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"},"dashboardUrl":{"type":"string","description":"Link to the contact's page in the CloudTalk Dashboard. It carries no credentials: the person must be signed in to your company's Dashboard, and your company must have Contacts in its menu, otherwise the Dashboard opens their default page. Read-only.","example":"https://dashboard.cloudtalk.io/menu/contacts/details/44210","isRequired":true,"uniqueKey":"dashboardUrl","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"44210","type":"contact","name":"Jane Doe","title":"Head of Procurement","company":"Acme Inc.","industry":"Manufacturing","website":"https://acme.example.com","address":"1 Market Street","city":"San Francisco","state":"CA","zip":"94105","country":{"code":"US","name":"United States"},"phones":["+12025550143","+13105550166"],"emails":["[email protected]"],"tags":[{"id":"123","name":"vip","readOnly":false}],"customFields":{"Segment":"enterprise"},"favoriteUserId":"7","source":"api","createdAt":"2026-08-17T09:34:21Z","updatedAt":"2026-10-02T14:05:11Z","dashboardUrl":"https://dashboard.cloudtalk.io/menu/contacts/details/44210"},"examples":{"Example":{"title":"Example","value":{"id":"44210","type":"contact","name":"Jane Doe","title":"Head of Procurement","company":"Acme Inc.","industry":"Manufacturing","website":"https://acme.example.com","address":"1 Market Street","city":"San Francisco","state":"CA","zip":"94105","country":{"code":"US","name":"United States"},"phones":["+12025550143","+13105550166"],"emails":["[email protected]"],"tags":[{"id":"123","name":"vip","readOnly":false}],"customFields":{"Segment":"enterprise"},"favoriteUserId":"7","source":"api","createdAt":"2026-08-17T09:34:21Z","updatedAt":"2026-10-02T14:05:11Z","dashboardUrl":"https://dashboard.cloudtalk.io/menu/contacts/details/44210"}}},"exampleType":"examples"}},"exampleType":"examples"},"85b5c23f-e645-455f-aeaa-72a0dbe9ec58":{"description":"A query parameter is unknown or repeated (code VALIDATION.INVALID_PARAMETER).","content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.0.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.0.items.[INDEX].message","typeLabel":"string"},"target":{"type":"string","uniqueKey":"error.details.oneOf.0.items.[INDEX].target","typeLabel":"string"}},"required":["code","message"],"type":"object","uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.details.oneOf.0","typeLabel":"object[]"},{"items":{"additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"},"target":{"type":"string"}},"required":["code","message"],"type":"object"},"type":"null","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object[] | null"},"target":{"type":"string","uniqueKey":"error.target","typeLabel":"string"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"required":["error","requestId"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":[{"code":"\u003cstring>","message":"\u003cstring>","target":"\u003cstring>"}],"target":"\u003cstring>"},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"d7fc4dee-f7dd-4756-90ef-961f90e89521":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","description":"Error envelope returned by the authentication layer in front of the `api.cloudtalk.io/v1` surface. It differs from the per-service error shapes used for other statuses.","properties":{"code":{"type":"string","description":"Error code","example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Error message","example":"You are not authorized to access this resource.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"example":{"code":"UNAUTHORIZED","message":"You are not authorized to access this resource."},"examples":{"Example":{"title":"Example","value":{"code":"UNAUTHORIZED","message":"You are not authorized to access this resource."}}},"exampleType":"examples"}},"exampleType":"examples"},"a8dfb5e4-ad5e-42a8-b104-a11ea4af4c80":{"description":"No contact with this id in your account (code CONTACTS.CONTACT_NOT_FOUND, `target: \"contactId\"`). An unknown id, a malformed id and another account's id get the same answer.","content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.0.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.0.items.[INDEX].message","typeLabel":"string"},"target":{"type":"string","uniqueKey":"error.details.oneOf.0.items.[INDEX].target","typeLabel":"string"}},"required":["code","message"],"type":"object","uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.details.oneOf.0","typeLabel":"object[]"},{"items":{"additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"},"target":{"type":"string"}},"required":["code","message"],"type":"object"},"type":"null","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object[] | null"},"target":{"type":"string","uniqueKey":"error.target","typeLabel":"string"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"required":["error","requestId"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":[{"code":"\u003cstring>","message":"\u003cstring>","target":"\u003cstring>"}],"target":"\u003cstring>"},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"5f2a43c5-c6ae-4551-bde7-edc64e307dbb":{"description":"Your company's contacts cannot be served by this API yet (code CONTACTS.NOT_AVAILABLE).","content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.0.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.0.items.[INDEX].message","typeLabel":"string"},"target":{"type":"string","uniqueKey":"error.details.oneOf.0.items.[INDEX].target","typeLabel":"string"}},"required":["code","message"],"type":"object","uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.details.oneOf.0","typeLabel":"object[]"},{"items":{"additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"},"target":{"type":"string"}},"required":["code","message"],"type":"object"},"type":"null","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object[] | null"},"target":{"type":"string","uniqueKey":"error.target","typeLabel":"string"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"required":["error","requestId"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":[{"code":"\u003cstring>","message":"\u003cstring>","target":"\u003cstring>"}],"target":"\u003cstring>"},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"7eeabb7a-9b7b-49ae-9a59-2b996ef3bd64":{"description":"Too many requests: this company is over the API rate limit (see the Rate limiting guide). The gateway answers before the request reaches the API, so there is no JSON error body; rely on the status and the headers X-CloudTalkAPI-Limit, X-CloudTalkAPI-Remaining and X-CloudTalkAPI-ResetTime.","headers":{"X-CloudTalkAPI-Limit":{"description":"Requests allowed per company in the current one-minute window.","schema":{"type":"integer"}},"X-CloudTalkAPI-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-CloudTalkAPI-ResetTime":{"description":"Unix timestamp (seconds) when the current window resets.","schema":{"type":"integer"}}},"content":{"text/plain":{"schema":{"type":"string","description":"Empty or a short plain-text reason from the gateway. Do not parse it.","uniqueKey":"","typeLabel":"string"},"example":"","examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"exampleType":"generated"},"3295acd0-ddf3-4a80-8874-2fbdfd74918b":{"description":"Unexpected server error (code INTERNAL). The message is always \"Internal error.\" and never carries upstream detail.","content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.0.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.0.items.[INDEX].message","typeLabel":"string"},"target":{"type":"string","uniqueKey":"error.details.oneOf.0.items.[INDEX].target","typeLabel":"string"}},"required":["code","message"],"type":"object","uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.details.oneOf.0","typeLabel":"object[]"},{"items":{"additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"},"target":{"type":"string"}},"required":["code","message"],"type":"object"},"type":"null","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object[] | null"},"target":{"type":"string","uniqueKey":"error.target","typeLabel":"string"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"required":["error","requestId"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":[{"code":"\u003cstring>","message":"\u003cstring>","target":"\u003cstring>"}],"target":"\u003cstring>"},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"49e174d5-5f0b-4b64-8b71-1105b881afce":{"description":"A service the Contacts API depends on could not be reached (code CONTACTS.UPSTREAM_UNAVAILABLE). Nothing was changed. Retry the request.","content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.0.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.oneOf.0.items.[INDEX].message","typeLabel":"string"},"target":{"type":"string","uniqueKey":"error.details.oneOf.0.items.[INDEX].target","typeLabel":"string"}},"required":["code","message"],"type":"object","uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.details.oneOf.0","typeLabel":"object[]"},{"items":{"additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"},"target":{"type":"string"}},"required":["code","message"],"type":"object"},"type":"null","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object[] | null"},"target":{"type":"string","uniqueKey":"error.target","typeLabel":"string"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"required":["error","requestId"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":[{"code":"\u003cstring>","message":"\u003cstring>","target":"\u003cstring>"}],"target":"\u003cstring>"},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"709dbfc2-8125-4794-9c14-16448a97d046":{"basicAuth":{"type":"http","scheme":"basic","description":"HTTP Basic Authentication. Use your API Access Key ID as the username and your API Access Key Secret as the password. Generate keys in the CloudTalk Dashboard under Account -> Settings -> API Keys (https://dashboard.cloudtalk.io/menu/account/settings/API-keys).","scopes":[],"schemeName":"basicAuth"}}},"servers":{"13d0ed27-3ba1-4f25-b7ae-4ef24d1bfb6a":{"url":"https://api.cloudtalk.io/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","description":"HTTP Basic Authentication. Use your API Access Key ID as the username and your API Access Key Secret as the password. Generate keys in the CloudTalk Dashboard under Account -> Settings -> API Keys (https://dashboard.cloudtalk.io/menu/account/settings/API-keys).","scopes":[],"schemeName":"basicAuth"},"schema":{"title":"Basic Auth","type":"object","description":"HTTP Basic Authentication. Use your API Access Key ID as the username and your API Access Key Secret as the password. Generate keys in the CloudTalk Dashboard under Account -> Settings -> API Keys (https://dashboard.cloudtalk.io/menu/account/settings/API-keys).","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"basicAuth","name":"Authorization"}],"title":"basicAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"cloudtalk","siteName":"CloudTalk Help Center","title":"Get a contact - CloudTalk Help Center","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/contacts/get-a-contact","matchLevel":0},"de":{"href":"/de","matchLevel":4},"es":{"href":"/es","matchLevel":4},"fr":{"href":"/fr","matchLevel":4},"nl":{"href":"/nl","matchLevel":4},"pt":{"href":"/pt","matchLevel":4}}},"lastModified":"2026-11-05T14:25:25.896Z","originalFileLocation":"api-reference/contacts/get-a-contact.mdx","locale":"en"},"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=\"Returns one contact with every number, email, tag and custom field. Integration tags are not listed in tags.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CloudTalk Help Center\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloudtalk/VvADT62SW6ZfhiGL/_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/cloudtalk/VvADT62SW6ZfhiGL/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloudtalk/VvADT62SW6ZfhiGL/_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/cloudtalk/VvADT62SW6ZfhiGL/_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/cloudtalk/VvADT62SW6ZfhiGL/_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/cloudtalk/VvADT62SW6ZfhiGL/_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/cloudtalk/VvADT62SW6ZfhiGL/_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/cloudtalk/VvADT62SW6ZfhiGL/_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/cloudtalk/VvADT62SW6ZfhiGL/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a contact - CloudTalk Help Center\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns one contact with every number, email, tag and custom field. Integration tags are not listed in tags.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CloudTalk Help Center\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.cloudtalk.io/api-reference/contacts/get-a-contact\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloudtalk.mintlify.app/_mintlify/api/og/v2?division=Contacts\u0026amp;title=Get+a+contact\u0026amp;description=Returns+one+contact+with+every+number%2C+email%2C+tag+and+custom+field.+Integration+tags+are+not+listed+in+%60tags%60.\u0026amp;theme=1e2a8314c967ca8053f46579\u0026amp;signature=28a9bdae5b98b5b3acded44e839c77d00b8ee877c1a96e2c1362ec4704b148d4\">\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 a contact - CloudTalk Help Center\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns one contact with every number, email, tag and custom field. Integration tags are not listed in tags.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloudtalk.mintlify.app/_mintlify/api/og/v2?division=Contacts\u0026amp;title=Get+a+contact\u0026amp;description=Returns+one+contact+with+every+number%2C+email%2C+tag+and+custom+field.+Integration+tags+are+not+listed+in+%60tags%60.\u0026amp;theme=1e2a8314c967ca8053f46579\u0026amp;signature=28a9bdae5b98b5b3acded44e839c77d00b8ee877c1a96e2c1362ec4704b148d4\">\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/cloudtalk/VvADT62SW6ZfhiGL/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CloudTalk Help Center\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0527FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.cloudtalk.io/api-reference/contacts/get-a-contact\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/contacts/get-a-contact.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://help.cloudtalk.io/#organization\",\"name\":\"CloudTalk Help Center\",\"url\":\"https://help.cloudtalk.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloudtalk/M_FX1uE099dO0_78/logo/light.svg?fit=max\u0026auto=format\u0026n=M_FX1uE099dO0_78\u0026q=85\u0026s=9efde0e0ef215d0b41a2f8f92056e144\"}},{\"@type\":\"WebSite\",\"@id\":\"https://help.cloudtalk.io#website\",\"name\":\"CloudTalk Help Center\",\"url\":\"https://help.cloudtalk.io\",\"publisher\":{\"@id\":\"https://help.cloudtalk.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://help.cloudtalk.io/api-reference/contacts/get-a-contact#webpage\",\"url\":\"https://help.cloudtalk.io/api-reference/contacts/get-a-contact\",\"name\":\"Get a contact\",\"description\":\"Returns one contact with every number, email, tag and custom field. Integration tags are not listed in tags.\",\"dateModified\":\"2026-11-05T14:25:25.896Z\",\"isPartOf\":{\"@id\":\"https://help.cloudtalk.io#website\"},\"breadcrumb\":{\"@id\":\"https://help.cloudtalk.io/api-reference/contacts/get-a-contact#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.cloudtalk.io/api-reference/contacts/get-a-contact#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://help.cloudtalk.io/api-reference/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Contacts\",\"item\":\"https://help.cloudtalk.io/api-reference/contacts/list-and-search-contacts\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Contacts\",\"item\":\"https://help.cloudtalk.io/api-reference/contacts/list-and-search-contacts\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Get a contact\",\"item\":\"https://help.cloudtalk.io/api-reference/contacts/get-a-contact\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://help.cloudtalk.io/api-reference/contacts/get-a-contact#apireference\",\"headline\":\"Get a contact\",\"name\":\"Get a contact\",\"description\":\"Returns one contact with every number, email, tag and custom field. Integration tags are not listed in tags.\",\"url\":\"https://help.cloudtalk.io/api-reference/contacts/get-a-contact\",\"mainEntityOfPage\":{\"@id\":\"https://help.cloudtalk.io/api-reference/contacts/get-a-contact#webpage\"},\"dateModified\":\"2026-11-05T14:25:25.896Z\",\"publisher\":{\"@id\":\"https://help.cloudtalk.io/#organization\"},\"isPartOf\":{\"@id\":\"https://help.cloudtalk.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CloudTalk Help Center\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"CloudTalk Help Center","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Help Center","pages":[{"title":"Help Center","href":"/en"}]},{"tab":"API","groups":[{"group":"Getting Started","pages":[{"title":"CloudTalk Developer Documentation","sidebarTitle":"Home","href":"/developers"},{"title":"CloudTalk REST API: Call Center Automation Platform","sidebarTitle":"Introduction","href":"/guides/introduction"},{"title":"How to Authenticate Requests to the CloudTalk REST API","sidebarTitle":"Authentication","href":"/guides/authentication"},{"title":"Quickstart: Make Your First CloudTalk REST API Call","sidebarTitle":"Quickstart","href":"/guides/quickstart"}]},{"group":"API Concepts","pages":[{"title":"CloudTalk API Response Envelope Formats and Schema","sidebarTitle":"Response Envelopes","href":"/guides/response-envelopes"},{"title":"How to Paginate CloudTalk API Collection Responses","sidebarTitle":"Pagination","href":"/guides/pagination"},{"title":"CloudTalk API Rate Limits, Headers, and Throttling","sidebarTitle":"Rate Limiting","href":"/guides/rate-limiting"},{"title":"CloudTalk API HTTP Error Codes: Causes and Resolutions","sidebarTitle":"Error Codes","href":"/guides/error-codes"}]},{"group":"API Guides","pages":[{"title":"Manage contacts with the API","sidebarTitle":"Contacts API","href":"/guides/contacts/manage-with-api"},{"title":"Read and set user status with the API","sidebarTitle":"User status API","href":"/guides/user-status/manage-with-api"}]},{"group":"API Reference","pages":[{"title":"API reference","sidebarTitle":"Overview","href":"/api-reference/overview"},{"group":"AI Voice Agents","pages":[{"title":"Initiate VoiceAgent call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /voice-agent/calls","href":"/api-reference/voiceagent/initiate-voiceagent-call"},{"title":"Stop outbound VoiceAgent calls","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /voice-agent/outbound/kill","href":"/api-reference/voiceagent/stop-outbound-voiceagent-calls"},{"title":"List voice agents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /voice-agents","href":"/api-reference/voiceagent/list-voice-agents"},{"title":"Create a voice agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /voice-agents","href":"/api-reference/voiceagent/create-a-voice-agent"},{"title":"Get a voice agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /voice-agents/{voiceAgentId}","href":"/api-reference/voiceagent/get-a-voice-agent"},{"title":"Replace a voice agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /voice-agents/{voiceAgentId}","href":"/api-reference/voiceagent/replace-a-voice-agent"},{"title":"Delete a voice agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /voice-agents/{voiceAgentId}","href":"/api-reference/voiceagent/delete-a-voice-agent"},{"title":"Attach a knowledge base to a voice agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /voice-agents/{voiceAgentId}/knowledge-bases/{knowledgeBaseId}","href":"/api-reference/voiceagent/attach-a-knowledge-base-to-a-voice-agent"},{"title":"Detach a knowledge base from a voice agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /voice-agents/{voiceAgentId}/knowledge-bases/{knowledgeBaseId}","href":"/api-reference/voiceagent/detach-a-knowledge-base-from-a-voice-agent"},{"title":"List knowledge bases","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /knowledge-bases","href":"/api-reference/voiceagent/list-knowledge-bases"},{"title":"Create a knowledge base","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /knowledge-bases","href":"/api-reference/voiceagent/create-a-knowledge-base"},{"title":"Upload a knowledge base file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /knowledge-bases/files","href":"/api-reference/voiceagent/upload-a-knowledge-base-file"},{"title":"Delete a knowledge base","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /knowledge-bases/{knowledgeBaseId}","href":"/api-reference/voiceagent/delete-a-knowledge-base"}]},{"group":"AI Conversation Intelligence","pages":[{"title":"Summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ai/calls/{callId}/summary","href":"/api-reference/conversation-intelligence/summary"},{"title":"Overall sentiment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ai/calls/{callId}/overall-sentiment","href":"/api-reference/conversation-intelligence/overall-sentiment"},{"title":"Talk-listen ratio","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ai/calls/{callId}/talk-listen-ratio","href":"/api-reference/conversation-intelligence/talk-listen-ratio"},{"title":"Topics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ai/calls/{callId}/topics","href":"/api-reference/conversation-intelligence/topics"},{"title":"Transcription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ai/calls/{callId}/transcription","href":"/api-reference/conversation-intelligence/transcription"},{"title":"Smart notes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ai/calls/{callId}/smart-notes","href":"/api-reference/conversation-intelligence/smart-notes"},{"title":"Call details link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ai/calls/{callId}/details-link","href":"/api-reference/conversation-intelligence/call-details-link"}]},{"group":"Contacts","pages":[{"group":"Contacts","pages":[{"title":"List and search contacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contacts","href":"/api-reference/contacts/list-and-search-contacts"},{"title":"Create a contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contacts","href":"/api-reference/contacts/create-a-contact"},{"title":"Look up contacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contacts/lookup","href":"/api-reference/contacts/look-up-contacts"},{"title":"Bulk upsert contacts","description":"Creates or updates 1 to 100 contacts in one call and returns one result per row, in request order. Each row is matched on `matchBy`: a row that matches an existing contact updates it, and any other row creates a contact. When a row matches several contacts, the most recently created one is updated and the others stay as they are, as on [Create a contact](/api-reference/contacts/create-a-contact). Rows in the same call that match each other end up as one contact, and each of those rows reports its id. When they create it, every one of those rows reports `operation: created`. Every row must carry a value it can be matched on, so retrying the same call updates the contacts it created instead of duplicating them. That is why this endpoint takes no `Idempotency-Key`.\n\n**Check each row.** The call answers `200` even when some rows fail. A row with `status: error` carries an `error` with a `code`, a `message` and a `target` that names the row, for example `contacts[1].emails[0]`. Row error codes: `VALIDATION.INVALID_FIELD` (including a row with nothing to match on, a row whose `customFields` has more than 100 keys, a `tagIds` value that is not a tag id, and a `favoriteUserId` that is not a user id), `CONTACTS.UNKNOWN_TAG` (a tag id that names no tag in your account), `CONTACTS.TAG_READ_ONLY`, `CONTACTS.UNKNOWN_CUSTOM_FIELD` and `CONTACTS.UNKNOWN_USER` (a user id that names no user in your account). A failed row is not written. Text fields are cleaned up before their length is checked and they are stored, as on [Create a contact](/api-reference/contacts/create-a-contact): emojis and other characters that take 4 bytes in UTF-8, and control characters such as line breaks and tabs, become a space; repeated whitespace becomes one space; and spaces at the start and end are removed.\n\n**After a server error.** Created rows are committed before updated rows, so a `5xx` answer can leave some rows applied. Retry the same call with the same `matchBy`: rows already applied are matched and updated, not created twice.\n\nEach `ok` row sends [`contact.created`](/guides/webhooks/events/contacts#contact-created), or [`contact.updated`](/guides/webhooks/events/contacts#contact-updated) when an existing contact changed. An updated row that changed nothing sends no webhook. CloudTalk also exports the contacts to your active CRM integrations.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contacts/bulk","href":"/api-reference/contacts/bulk-upsert-contacts"},{"title":"Get a contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contacts/{contactId}","href":"/api-reference/contacts/get-a-contact"},{"title":"Delete a contact","description":"Permanently deletes the contact with its numbers, emails, tags and custom field values. This cannot be undone.\n\n- Calls with this contact stay in your call history, but they are no longer linked to the contact.\n- Dialer campaigns that selected the contact by tag drop it at the next Dialer reconcile (every 5 minutes by default).\n- A [`contact.deleted`](/guides/webhooks/events/contacts#contact-deleted) webhook is sent.\n- Deleting the same contact again returns `404`: treat it as done.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /contacts/{contactId}","href":"/api-reference/contacts/delete-a-contact"},{"title":"Update a contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /contacts/{contactId}","href":"/api-reference/contacts/update-a-contact"},{"title":"Add tags to a contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contacts/{contactId}/tags","href":"/api-reference/contacts/add-tags-to-a-contact"},{"title":"Remove tags from a contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /contacts/{contactId}/tags","href":"/api-reference/contacts/remove-tags-from-a-contact"}]},{"group":"Contact tags","pages":[{"title":"List contact tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contact-tags","href":"/api-reference/contacts/list-contact-tags"},{"title":"Create a contact tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contact-tags","href":"/api-reference/contacts/create-a-contact-tag"},{"title":"Delete a contact tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /contact-tags/{tagId}","href":"/api-reference/contacts/delete-a-contact-tag"},{"title":"Rename a contact tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /contact-tags/{tagId}","href":"/api-reference/contacts/rename-a-contact-tag"}]},{"group":"Contact fields","pages":[{"title":"List contact fields","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contact-fields","href":"/api-reference/contacts/list-contact-fields"}]}]},{"group":"AI Sales Dialer \u0026 Campaigns","pages":[{"group":"AI Sales Dialer","pages":[{"title":"List call scripts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/scripts","href":"/api-reference/dialer/list-call-scripts"},{"title":"Create a call script","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /dialer/scripts","href":"/api-reference/dialer/create-a-call-script"},{"title":"Get a call script","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/scripts/{scriptId}","href":"/api-reference/dialer/get-a-call-script"},{"title":"Archive a call script","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /dialer/scripts/{scriptId}","href":"/api-reference/dialer/archive-a-call-script"},{"title":"Update a call script","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /dialer/scripts/{scriptId}","href":"/api-reference/dialer/update-a-call-script"},{"title":"List surveys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/surveys","href":"/api-reference/dialer/list-surveys"},{"title":"Create a survey","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /dialer/surveys","href":"/api-reference/dialer/create-a-survey"},{"title":"Get a survey","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/surveys/{surveyId}","href":"/api-reference/dialer/get-a-survey"},{"title":"Rename or archive a survey","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /dialer/surveys/{surveyId}","href":"/api-reference/dialer/rename-or-archive-a-survey"},{"title":"Replace a survey's questions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /dialer/surveys/{surveyId}/questions","href":"/api-reference/dialer/replace-a-surveys-questions"},{"title":"List disposition tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/disposition-tags","href":"/api-reference/dialer/list-disposition-tags"}]},{"group":"Campaigns","pages":[{"title":"List dialer campaigns","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/campaigns","href":"/api-reference/dialer/list-dialer-campaigns"},{"title":"Create a dialer campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /dialer/campaigns","href":"/api-reference/dialer/create-a-dialer-campaign"},{"title":"Get a dialer campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/campaigns/{campaignId}","href":"/api-reference/dialer/get-a-dialer-campaign"},{"title":"Delete a dialer campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /dialer/campaigns/{campaignId}","href":"/api-reference/dialer/delete-a-dialer-campaign"},{"title":"Update a dialer campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /dialer/campaigns/{campaignId}","href":"/api-reference/dialer/update-a-dialer-campaign"},{"title":"Get a campaign's associations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/campaigns/{campaignId}/associations","href":"/api-reference/dialer/get-a-campaigns-associations"},{"title":"Replace a campaign's associations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /dialer/campaigns/{campaignId}/associations","href":"/api-reference/dialer/replace-a-campaigns-associations"},{"title":"Get a campaign's disposition buttons","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/campaigns/{campaignId}/disposition-buttons","href":"/api-reference/dialer/get-a-campaigns-disposition-buttons"},{"title":"Replace a campaign's disposition buttons","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /dialer/campaigns/{campaignId}/disposition-buttons","href":"/api-reference/dialer/replace-a-campaigns-disposition-buttons"},{"title":"Get a campaign's statistics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/campaigns/{campaignId}/statistics","href":"/api-reference/dialer/get-a-campaigns-statistics"},{"title":"List a campaign's contacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/campaigns/{campaignId}/contacts","href":"/api-reference/dialer/list-a-campaigns-contacts"},{"title":"Peek at the next contacts to be dialed","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/campaigns/{campaignId}/contacts/next","href":"/api-reference/dialer/peek-at-the-next-contacts-to-be-dialed"},{"title":"Get one campaign contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/campaigns/{campaignId}/contacts/{campaignContactId}","href":"/api-reference/dialer/get-one-campaign-contact"},{"title":"Request a campaign data export","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /dialer/campaigns/{campaignId}/exports","href":"/api-reference/dialer/request-a-campaign-data-export"},{"title":"Get an export job's status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/exports/{jobId}","href":"/api-reference/dialer/get-an-export-jobs-status"},{"title":"Get a download link for a completed export","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dialer/exports/{jobId}/download","href":"/api-reference/dialer/get-a-download-link-for-a-completed-export"}]}]},{"group":"Calls","pages":[{"title":"Call history","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/index.json","href":"/api-reference/calls/call-history"},{"title":"Get call details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{callId}","href":"/api-reference/calls/get-call-details"},{"title":"Recording media","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/recording/{callId}.json","href":"/api-reference/calls/recording-media"},{"title":"Delete call recording","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /recordings/delete/{callId}.json","href":"/api-reference/calls/delete-call-recording"},{"title":"Make a call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /calls/create.json","href":"/api-reference/calls/make-a-call"},{"title":"Group statistics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /statistics/realtime/groups.json","href":"/api-reference/calls/group-statistics"}]},{"group":"Call tags","pages":[{"title":"List call tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /call-tags","href":"/api-reference/call-tags/list-call-tags"},{"title":"List a call's tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{callId}/tags","href":"/api-reference/call-tags/list-a-calls-tags"},{"title":"Add tags to a call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /calls/{callId}/tags","href":"/api-reference/call-tags/add-tags-to-a-call"},{"title":"Remove tags from a call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /calls/{callId}/tags","href":"/api-reference/call-tags/remove-tags-from-a-call"}]},{"group":"Messaging","pages":[{"title":"Send sms","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /sms/send.json","href":"/api-reference/sms/send-sms"}]},{"group":"Numbers","pages":[{"title":"List numbers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /numbers/index.json","href":"/api-reference/numbers/list-numbers"},{"title":"Edit a number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /numbers/edit/{id}.json","href":"/api-reference/numbers/edit-a-number"},{"title":"Unregister a number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /numbers/clear/{id}.json","href":"/api-reference/numbers/unregister-a-number"}]},{"group":"User status","pages":[{"title":"List user statuses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /user-statuses","href":"/api-reference/user-status/list-user-statuses"},{"title":"Get a user's status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /user-statuses/{userId}","href":"/api-reference/user-status/get-a-users-status"},{"title":"Set a user's status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /user-statuses/{userId}","href":"/api-reference/user-status/set-a-users-status"},{"title":"List user status types","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /user-status-types","href":"/api-reference/user-status/list-user-status-types"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/index.json","href":"/api-reference/agents/list-agents"},{"title":"Add an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /agents/add.json","href":"/api-reference/agents/add-an-agent"},{"title":"Edit an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/edit/{agentId}.json","href":"/api-reference/agents/edit-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/delete/{agentId}.json","href":"/api-reference/agents/delete-an-agent"}]},{"group":"Groups","pages":[{"title":"List groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /groups/index.json","href":"/api-reference/groups/list-groups"},{"title":"Add agent to group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /groups/add.json","href":"/api-reference/groups/add-agent-to-group"},{"title":"Remove agent from group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /groups/delete/{agent_id}.json","href":"/api-reference/groups/remove-agent-from-group"}]},{"group":"Webhooks","pages":[{"title":"List webhook event types","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhooks/event-types","href":"/api-reference/webhooks/list-webhook-event-types"},{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhooks/endpoints","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webhooks/endpoints","href":"/api-reference/webhooks/create-a-webhook-endpoint"},{"title":"Get a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhooks/endpoints/{endpointId}","href":"/api-reference/webhooks/get-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /webhooks/endpoints/{endpointId}","href":"/api-reference/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /webhooks/endpoints/{endpointId}","href":"/api-reference/webhooks/update-a-webhook-endpoint"},{"title":"Get the signing secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhooks/endpoints/{endpointId}/secret","href":"/api-reference/webhooks/get-the-signing-secret"},{"title":"Rotate the signing secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webhooks/endpoints/{endpointId}/secret/rotate","href":"/api-reference/webhooks/rotate-the-signing-secret"},{"title":"Send a test event","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webhooks/endpoints/{endpointId}/test","href":"/api-reference/webhooks/send-a-test-event"},{"title":"List deliveries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhooks/endpoints/{endpointId}/deliveries","href":"/api-reference/webhooks/list-deliveries"},{"title":"Get a delivery","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhooks/endpoints/{endpointId}/deliveries/{deliveryId}","href":"/api-reference/webhooks/get-a-delivery"},{"title":"Retry a delivery","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webhooks/endpoints/{endpointId}/deliveries/{deliveryId}/retry","href":"/api-reference/webhooks/retry-a-delivery"}]},{"group":"Utilities","pages":[{"title":"List countries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /countries/index.json","href":"/api-reference/utilities/list-countries"},{"title":"List blacklist","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /blacklist/index.json","href":"/api-reference/utilities/list-blacklist"},{"title":"Add number to blacklist","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /blacklist/add.json","href":"/api-reference/utilities/add-number-to-blacklist"},{"title":"Edit number on blacklist","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /blacklist/edit/{id}.json","href":"/api-reference/utilities/edit-number-on-blacklist"},{"title":"Delete number from blacklist","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /blacklist/delete/{id}.json","href":"/api-reference/utilities/delete-number-from-blacklist"}]},{"group":"CueCard","pages":[{"title":"Create CueCard","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cuecards","href":"/api-reference/cuecard/create-cuecard"}]},{"group":"Legacy","expanded":false,"pages":[{"group":"Contacts (LEGACY)","pages":[{"title":"List contacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contacts/index.json","href":"/api-reference/contacts-legacy/list-contacts"},{"title":"Add contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /contacts/add.json","href":"/api-reference/contacts-legacy/add-contact"},{"title":"Edit contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contacts/edit/{contactId}.json","href":"/api-reference/contacts-legacy/edit-contact"},{"title":"Delete contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /contacts/delete/{contactId}.json","href":"/api-reference/contacts-legacy/delete-contact"},{"title":"Inspect a contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contacts/show/{contactId}.json","href":"/api-reference/contacts-legacy/inspect-a-contact"},{"title":"Attributes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contacts/attributes.json","href":"/api-reference/contacts-legacy/attributes"},{"title":"Assign contact tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /contacts/addTags/{contactId}.json","href":"/api-reference/contacts-legacy/assign-contact-tags"},{"title":"Unassign contact tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /contacts/removeTags/{contactId}.json","href":"/api-reference/contacts-legacy/unassign-contact-tags"},{"title":"List notes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /notes/index.json","href":"/api-reference/contacts-legacy/list-notes"},{"title":"Add note","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /notes/add/{contactId}.json","href":"/api-reference/contacts-legacy/add-note"},{"title":"Edit note","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /notes/edit/{noteId}.json","href":"/api-reference/contacts-legacy/edit-note"},{"title":"Delete note","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /notes/delete/{noteId}.json","href":"/api-reference/contacts-legacy/delete-note"},{"title":"List activities","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /activity/index.json","href":"/api-reference/contacts-legacy/list-activities"},{"title":"Add activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /activity/add/{contactId}.json","href":"/api-reference/contacts-legacy/add-activity"},{"title":"Edit activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /activity/edit/{activityId}.json","href":"/api-reference/contacts-legacy/edit-activity"},{"title":"Delete activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /activity/delete/{activityId}.json","href":"/api-reference/contacts-legacy/delete-activity"}]},{"group":"Contact tags (LEGACY)","pages":[{"title":"List contact tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /tags/index.json","href":"/api-reference/contact-tags-legacy/list-contact-tags"},{"title":"Add a contact tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /tags/add.json","href":"/api-reference/contact-tags-legacy/add-a-contact-tag"},{"title":"Edit a contact tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /tags/edit/{id}.json","href":"/api-reference/contact-tags-legacy/edit-a-contact-tag"},{"title":"Delete a contact tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /tags/delete/{id}.json","href":"/api-reference/contact-tags-legacy/delete-a-contact-tag"}]},{"group":"Bulks (LEGACY)","pages":[{"title":"Contact actions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /bulk/contacts.json","href":"/api-reference/bulks-legacy/contact-actions"}]},{"group":"Campaigns (LEGACY)","pages":[{"title":"List campaigns","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /campaigns/index.json","href":"/api-reference/campaigns-legacy/list-campaigns"},{"title":"Add campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /campaigns/add.json","href":"/api-reference/campaigns-legacy/add-campaign"},{"title":"Edit campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /campaigns/edit/{id}.json","href":"/api-reference/campaigns-legacy/edit-campaign"},{"title":"Delete campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /campaigns/delete/{id}.json","href":"/api-reference/campaigns-legacy/delete-campaign"}]}]}]}]},{"tab":"Webhooks","pages":[{"title":"Webhooks","href":"/guides/webhooks/overview"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/guides/mcp/overview"}]},{"tab":"What's new","pages":[{"title":"What's new","href":"/changelog"}]}]},{"language":"de","pages":[{"title":"de","href":"/de"}]},{"language":"es","pages":[{"title":"es","href":"/es"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr"}]},{"language":"nl","pages":[{"title":"nl","href":"/nl"}]},{"language":"pt","pages":[{"title":"pt","href":"/pt"}]}]},"basePath":"","title":"Get a contact - CloudTalk Help Center","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}