{
"success": false,
"message": "Internal server error"
}
Returns telephone encounters synced from the EHR, newest first, with their status,
assignee and actions. Use an encounter’s id to add an action with
POST /telephone-encounters/actions.
Subscribe to the telephone_encounter.updatedsync event to hear when an
encounter changes (addressed, reassigned, new actions or notes) without polling.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cobalt","colors":{"primary":"#576dee","light":"#8a9af4","dark":"#3a4cbc"},"logo":{"light":"https://mintcdn.com/cobalt-cd7844c1/ARV8r_xeyMO_zivG/logo/light.svg?fit=max\u0026auto=format\u0026n=ARV8r_xeyMO_zivG\u0026q=85\u0026s=de8566184dd7d19c926d1f0e5ee04d74","dark":"https://mintcdn.com/cobalt-cd7844c1/ARV8r_xeyMO_zivG/logo/dark.svg?fit=max\u0026auto=format\u0026n=ARV8r_xeyMO_zivG\u0026q=85\u0026s=c9b017690a9cf87eea9b8c1a41a0330e"},"favicon":"https://mintcdn.com/cobalt-cd7844c1/NyZchDiv0WDjeFlo/favicon.svg?fit=max\u0026auto=format\u0026n=NyZchDiv0WDjeFlo\u0026q=85\u0026s=f4adc378c31a71ebba62a9d5d28f3bb6","navbar":{"links":[{"href":"mailto:bryan@usecobalt.com","label":"Support"}]},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/usecobalt"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cobalt-cd7844c1","hasAudioNarration":false,"actualSubdomain":"cobalt-cd7844c1","customDomains":["docs.usecobalt.com"],"gitSource":{"type":"github","owner":"cobalt-technology","repo":"docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae3a76cfe0d011f8977bace","collectionId":"b9301a7c-29c5-41c4-a9fd-dd1ff9be9877","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae3a76cfe0d011f8977bace"},"entitlements":{},"buildId":"6ae52edb5958974ecfd2d702","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API Reference","count":89},{"language":"default","tag":"Guides","count":31},{"language":"default","tag":"Webhooks","count":13},{"language":"default","tag":"Account","count":8},{"language":"default","tag":"Orders","count":6},{"language":"default","tag":"Patients","count":6},{"language":"default","tag":"Appointments","count":5},{"language":"default","tag":"Link","count":5},{"language":"default","tag":"Claims","count":4},{"language":"default","tag":"Documents","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":"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":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/telephone-encounters/list","slug":"/api-reference/telephone-encounters/list","pageMetadata":{"title":"List Telephone Encounters","openapi":"GET /telephone-encounters","description":"List telephone encounters synced from the EHR, filtered by date, assignee, status and more.","href":"/api-reference/telephone-encounters/list"},"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: \"List telephone encounters synced from the EHR, filtered by date, assignee, status and more.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Returns telephone encounters synced from the EHR, newest first, with their status,\nassignee and actions. Use an encounter’s `,_jsx(_components.code,{children:`id`}),` to add an action with\n`,_jsx(_components.a,{href:`/api-reference/telephone-encounters/create-action`,children:`POST /telephone-encounters/actions`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`start_date`}),` (string, required): Start of the date range (YYYY-MM-DD, inclusive). Matches the encounter date in the EHR.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`end_date`}),` (string, required): End of the date range (YYYY-MM-DD, inclusive).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`patient_mrn`}),` (string, optional): Patient MRN.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`assigned_to_ehr_id`}),` (string, optional): Assignee’s staff `,_jsx(_components.code,{children:`ehr_id`}),` from `,_jsx(_components.a,{href:`/api-reference/staff/get`,children:`GET /staff`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`assigned_to_name`}),` (string, optional): Assignee name as shown in the EHR, e.g. `,_jsx(_components.code,{children:`Smith, Alex`}),`. Case- and space-insensitive.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`created_by`}),` (string, optional): Name of the user who created the encounter, as shown in the EHR. Case- and space-insensitive.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`locked`}),` (string, optional): `,_jsx(_components.code,{children:`true`}),` for only addressed (locked) encounters, `,_jsx(_components.code,{children:`false`}),` for only open ones.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`reason`}),` (string, optional): Keyword in the reason, case-insensitive.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`page`}),` (integer, optional): Page number (default: 1).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`page_size`}),` (integer, optional): Results per page, max 100 (default: 100).`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`example-request`,children:`Example Request`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -G`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.usecobalt.com/v1/telephone-encounters\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"client_id: your_client_id\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"client_secret: your_client_secret\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"access_token: your_access_token\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"start_date=2026-10-05\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"end_date=2026-10-07\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"assigned_to_ehr_id=52685\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"locked=false\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`example-response`,children:`Example Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`46`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`46`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"telephone_encounters\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7d2e4f1a9c3b4e8d8a6f2b1c0d9e8f7a\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ehr_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"85479379\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"patient_mrn\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12345\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"patient_ehr_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3912234\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"encounter_datetime\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-06T16:30:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reason\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Medication refill\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"caller\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Doe, Jane (patient)\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Patient requests a refill of their blood pressure medication.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"notes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"open\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"locked\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"locked_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"assigned_to_ehr_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"52685\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"assigned_to_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Smith, Alex\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_by\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Doe, Jordan\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"answered_by\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Doe, Jordan\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"provider_ehr_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12241\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"provider_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Lee, Morgan\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"location_ehr_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"25\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"location_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Main Office\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_high_priority\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"has_attachment\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"actions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"by\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Doe, Jordan\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-06T16:42:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"text\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Sent refill request to provider.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ehr_created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-06T16:30:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ehr_updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-06T16:42:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-06T16:45:10.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-06T16:45:10.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pagination\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"page_size\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_pages\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`staying-up-to-date`,children:`Staying Up To Date`}),`\n`,_jsxs(_components.p,{children:[`Subscribe to the `,_jsx(_components.code,{children:`telephone_encounter.updated`}),`\n`,_jsx(_components.a,{href:`/docs/webhooks/sync-events#telephone-encounter-events`,children:`sync event`}),` to hear when an\nencounter changes (addressed, reassigned, new actions or notes) without polling.`]}),`\n`,_jsx(Heading,{level:`2`,id:`status-codes`,children:`Status Codes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`200`}),`: Telephone encounters returned.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`400`}),`: Missing or invalid dates, an invalid filter value, or an invalid `,_jsx(_components.code,{children:`page`}),` / `,_jsx(_components.code,{children:`page_size`}),`.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List Telephone Encounters","openapi":"GET /telephone-encounters","description":"List telephone encounters synced from the EHR, filtered by date, assignee, status and more.","href":"/api-reference/telephone-encounters/list"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Example Request","slug":"example-request","depth":2,"children":[]},{"title":"Example Response","slug":"example-response","depth":2,"children":[]},{"title":"Staying Up To Date","slug":"staying-up-to-date","depth":2,"children":[]},{"title":"Status Codes","slug":"status-codes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getTelephoneEncounters","summary":"List telephone encounters","description":"List telephone encounters synced from the EHR, filtered by date, assignee, status and more.","tags":["Telephone Encounters"],"x-supported-emrs":["eClinicalWorks"],"parameters":["5d1cf867-7b63-4487-88cc-b487bbd28ce6","2c67cf1e-b028-4662-ba09-c71676b58ed3","5599b15b-b0ca-4ec0-987a-d00fd15266e6","54067ec4-4ee4-4114-9dd3-bcf3c1943c2a","590a0815-8e31-42a4-9ff7-bb392688651f","42e9a4b5-a98e-4cc2-aaa6-4bc366ebe189","c384431d-87dc-47d4-8b5f-cf89a5531a36","ad560cd4-c286-4db0-bee3-cd0979f63329","0830fee9-63d4-4641-b7e4-71b4867ad470","ba247807-4168-44f4-911f-65f5b7ed8342"],"responses":{"200":"04ed4a4f-a7bc-4c0a-96b1-7788db9df586","400":"e1529690-2ef2-40e8-bf42-c54bb2d6f327","401":"0afa352f-d0f2-47d1-bd94-f95107c8c591","500":"fa067f13-ff76-4afa-8170-8df390110258"},"method":"get","type":"path","servers":["f56cf696-d7e1-42f2-84ed-ba4b6c59895c"],"security":["dfe066b4-9ea4-4b13-bbb2-e70555399a46"],"path":"/telephone-encounters","baseUrlOptions":["https://api.usecobalt.com/v1"],"title":"List telephone encounters","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5d1cf867-7b63-4487-88cc-b487bbd28ce6":{"name":"start_date","in":"query","description":"Start of the date range (YYYY-MM-DD, inclusive), matched against the encounter date in the EHR.","schema":{"type":"string","example":"2026-03-15","isRequired":true,"description":"Start of the date range (YYYY-MM-DD, inclusive), matched against the encounter date in the EHR.","uniqueKey":"","typeLabel":"string"},"required":true,"x-supported-emrs":["eClinicalWorks"]},"2c67cf1e-b028-4662-ba09-c71676b58ed3":{"name":"end_date","in":"query","description":"End of the date range (YYYY-MM-DD, inclusive).","schema":{"type":"string","example":"2026-03-20","isRequired":true,"description":"End of the date range (YYYY-MM-DD, inclusive).","uniqueKey":"","typeLabel":"string"},"required":true,"x-supported-emrs":["eClinicalWorks"]},"5599b15b-b0ca-4ec0-987a-d00fd15266e6":{"name":"patient_mrn","in":"query","description":"Filter by patient Medical Record Number.","schema":{"type":"string","example":"12345","isRequired":false,"description":"Filter by patient Medical Record Number.","uniqueKey":"","typeLabel":"string"},"required":false,"x-supported-emrs":["eClinicalWorks"]},"54067ec4-4ee4-4114-9dd3-bcf3c1943c2a":{"name":"assigned_to_ehr_id","in":"query","description":"Filter by assignee: a staff `ehr_id` from GET /v1/staff.","schema":{"type":"string","example":"staff-123","isRequired":false,"description":"Filter by assignee: a staff `ehr_id` from GET /v1/staff.","uniqueKey":"","typeLabel":"string"},"required":false,"x-supported-emrs":["eClinicalWorks"]},"590a0815-8e31-42a4-9ff7-bb392688651f":{"name":"assigned_to_name","in":"query","description":"Filter by assignee name as shown in the EHR (e.g. \"Smith, Jane\"), case- and space-insensitive.","schema":{"type":"string","example":"Smith, Alex","isRequired":false,"description":"Filter by assignee name as shown in the EHR (e.g. \"Smith, Jane\"), case- and space-insensitive.","uniqueKey":"","typeLabel":"string"},"required":false,"x-supported-emrs":["eClinicalWorks"]},"42e9a4b5-a98e-4cc2-aaa6-4bc366ebe189":{"name":"created_by","in":"query","description":"Filter by the user who created the encounter, as shown in the EHR (e.g. \"Smith, Jane\"), case- and space-insensitive.","schema":{"type":"string","example":"Smith, Alex","isRequired":false,"description":"Filter by the user who created the encounter, as shown in the EHR (e.g. \"Smith, Jane\"), case- and space-insensitive.","uniqueKey":"","typeLabel":"string"},"required":false,"x-supported-emrs":["eClinicalWorks"]},"c384431d-87dc-47d4-8b5f-cf89a5531a36":{"name":"locked","in":"query","description":"\"true\" returns only addressed (locked) encounters; \"false\" only open ones.","schema":{"type":"string","enum":["true","false"],"example":"false","isRequired":false,"description":"\"true\" returns only addressed (locked) encounters; \"false\" only open ones.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":false,"x-supported-emrs":["eClinicalWorks"]},"ad560cd4-c286-4db0-bee3-cd0979f63329":{"name":"reason","in":"query","description":"Filter by a keyword in the reason, case-insensitive.","schema":{"type":"string","example":"refill","isRequired":false,"description":"Filter by a keyword in the reason, case-insensitive.","uniqueKey":"","typeLabel":"string"},"required":false,"x-supported-emrs":["eClinicalWorks"]},"0830fee9-63d4-4641-b7e4-71b4867ad470":{"name":"page","in":"query","description":"Page number (default 1).","schema":{"type":"string","example":"1","isRequired":false,"description":"Page number (default 1).","uniqueKey":"","typeLabel":"string"},"required":false,"x-supported-emrs":["eClinicalWorks"]},"ba247807-4168-44f4-911f-65f5b7ed8342":{"name":"page_size","in":"query","description":"Results per page (1-100, default 100).","schema":{"type":"string","example":"100","isRequired":false,"description":"Results per page (1-100, default 100).","uniqueKey":"","typeLabel":"string"},"required":false,"x-supported-emrs":["eClinicalWorks"]}},"responses":{"04ed4a4f-a7bc-4c0a-96b1-7788db9df586":{"description":"Telephone encounters for the account","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"telephone_encounters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Cobalt telephone encounter ID (dashless UUID). Use it to add an action with POST /v1/telephone-encounters/actions.","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].id","typeLabel":"string"},"ehr_id":{"type":"string","description":"Encounter ID in the EHR.","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].ehr_id","typeLabel":"string"},"patient_mrn":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].patient_mrn.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].patient_mrn.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].patient_mrn","typeLabel":"string | null"},"patient_ehr_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].patient_ehr_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].patient_ehr_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].patient_ehr_id","typeLabel":"string | null"},"encounter_datetime":{"oneOf":[{"type":"string","description":"Encounter date and time in the EHR (ISO 8601).","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].encounter_datetime.oneOf.0","typeLabel":"string"},{"type":"null","description":"Encounter date and time in the EHR (ISO 8601).","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].encounter_datetime.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].encounter_datetime","typeLabel":"string | null"},"reason":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].reason.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].reason","typeLabel":"string | null"},"caller":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].caller.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].caller.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].caller","typeLabel":"string | null"},"message":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].message.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].message.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].message","typeLabel":"string | null"},"notes":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].notes.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].notes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].notes","typeLabel":"string | null"},"status":{"type":"string","enum":["open","addressed"],"description":"\"addressed\" once the encounter is locked in the EHR.","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"locked":{"type":"boolean","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].locked","typeLabel":"boolean"},"locked_at":{"oneOf":[{"type":"string","description":"When the encounter was addressed (locked) in the EHR, from its audit log.","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].locked_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the encounter was addressed (locked) in the EHR, from its audit log.","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].locked_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].locked_at","typeLabel":"string | null"},"assigned_to_ehr_id":{"oneOf":[{"type":"string","description":"Assignee staff `ehr_id` (GET /v1/staff).","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].assigned_to_ehr_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Assignee staff `ehr_id` (GET /v1/staff).","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].assigned_to_ehr_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].assigned_to_ehr_id","typeLabel":"string | null"},"assigned_to_name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].assigned_to_name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].assigned_to_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].assigned_to_name","typeLabel":"string | null"},"created_by":{"oneOf":[{"type":"string","description":"User who created the encounter in the EHR.","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].created_by.oneOf.0","typeLabel":"string"},{"type":"null","description":"User who created the encounter in the EHR.","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].created_by.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].created_by","typeLabel":"string | null"},"answered_by":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].answered_by.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].answered_by.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].answered_by","typeLabel":"string | null"},"provider_ehr_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].provider_ehr_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].provider_ehr_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].provider_ehr_id","typeLabel":"string | null"},"provider_name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].provider_name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].provider_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].provider_name","typeLabel":"string | null"},"location_ehr_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].location_ehr_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].location_ehr_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].location_ehr_id","typeLabel":"string | null"},"location_name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].location_name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].location_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].location_name","typeLabel":"string | null"},"is_high_priority":{"type":"boolean","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].is_high_priority","typeLabel":"boolean"},"has_attachment":{"type":"boolean","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].has_attachment","typeLabel":"boolean"},"actions":{"type":"array","items":{"type":"object","properties":{"by":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].actions.items.[INDEX].by.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].actions.items.[INDEX].by.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].actions.items.[INDEX].by","typeLabel":"string | null"},"at":{"oneOf":[{"type":"string","description":"ISO 8601.","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].actions.items.[INDEX].at.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 8601.","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].actions.items.[INDEX].at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].actions.items.[INDEX].at","typeLabel":"string | null"},"text":{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].actions.items.[INDEX].text","typeLabel":"string"}},"required":["by","at","text"],"uniqueKey":"telephone_encounters.items.[INDEX].actions.items.[INDEX]","typeLabel":"object"},"description":"Actions taken on the encounter, oldest first.","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].actions","typeLabel":"object[]"},"ehr_created_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].ehr_created_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].ehr_created_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].ehr_created_at","typeLabel":"string | null"},"ehr_updated_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].ehr_updated_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].ehr_updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].ehr_updated_at","typeLabel":"string | null"},"created_at":{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].created_at","typeLabel":"string"},"updated_at":{"type":"string","isRequired":true,"uniqueKey":"telephone_encounters.items.[INDEX].updated_at","typeLabel":"string"}},"required":["id","ehr_id","patient_mrn","patient_ehr_id","encounter_datetime","reason","caller","message","notes","status","locked","locked_at","assigned_to_ehr_id","assigned_to_name","created_by","answered_by","provider_ehr_id","provider_name","location_ehr_id","location_name","is_high_priority","has_attachment","actions","ehr_created_at","ehr_updated_at","created_at","updated_at"],"uniqueKey":"telephone_encounters.items.[INDEX]","typeLabel":"object"},"example":[{"id":"encounter-123","ehr_id":"85479379","patient_mrn":"12345","patient_ehr_id":"3912234","encounter_datetime":"2026-06-15T21:30:00Z","reason":"Medication refill","caller":"Jane Doe (patient)","message":"Patient requests a refill of their blood pressure medication.","notes":null,"status":"addressed","locked":true,"locked_at":"2026-06-15T21:30:00Z","assigned_to_ehr_id":"staff-123","assigned_to_name":"Smith, Alex","created_by":"Doe, Jordan","answered_by":"Doe, Jordan","provider_ehr_id":"provider-123","provider_name":"Lee, Sam","location_ehr_id":"location-1","location_name":"Main Clinic","is_high_priority":false,"has_attachment":false,"actions":[{"by":"Smith, Alex","at":"2026-06-15T21:30:00Z","text":"Called patient; left a message about their results."}],"ehr_created_at":"2026-06-15T21:30:00Z","ehr_updated_at":"2026-06-15T21:30:00Z","created_at":"2026-06-15T21:30:00Z","updated_at":"2026-06-15T21:30:00Z"}],"isRequired":true,"uniqueKey":"telephone_encounters","typeLabel":"object[]"},"pagination":{"type":"object","properties":{"page":{"type":"integer","example":1,"isRequired":true,"uniqueKey":"pagination.page","typeLabel":"integer"},"page_size":{"type":"integer","example":25,"isRequired":true,"uniqueKey":"pagination.page_size","typeLabel":"integer"},"total_count":{"type":"integer","example":1,"isRequired":true,"uniqueKey":"pagination.total_count","typeLabel":"integer"},"total_pages":{"type":"integer","example":1,"isRequired":true,"uniqueKey":"pagination.total_pages","typeLabel":"integer"}},"required":["page","page_size","total_count","total_pages"],"isRequired":true,"uniqueKey":"pagination","typeLabel":"object"}},"required":["success","telephone_encounters","pagination"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"telephone_encounters":[{"id":"encounter-123","ehr_id":"85479379","patient_mrn":"12345","patient_ehr_id":"3912234","encounter_datetime":"2026-06-15T21:30:00Z","reason":"Medication refill","caller":"Jane Doe (patient)","message":"Patient requests a refill of their blood pressure medication.","notes":null,"status":"addressed","locked":true,"locked_at":"2026-06-15T21:30:00Z","assigned_to_ehr_id":"staff-123","assigned_to_name":"Smith, Alex","created_by":"Doe, Jordan","answered_by":"Doe, Jordan","provider_ehr_id":"provider-123","provider_name":"Lee, Sam","location_ehr_id":"location-1","location_name":"Main Clinic","is_high_priority":false,"has_attachment":false,"actions":[{"by":"Smith, Alex","at":"2026-06-15T21:30:00Z","text":"Called patient; left a message about their results."}],"ehr_created_at":"2026-06-15T21:30:00Z","ehr_updated_at":"2026-06-15T21:30:00Z","created_at":"2026-06-15T21:30:00Z","updated_at":"2026-06-15T21:30:00Z"}],"pagination":{"page":1,"page_size":25,"total_count":1,"total_pages":1}}}},"exampleType":"generated"}},"exampleType":"generated"},"e1529690-2ef2-40e8-bf42-c54bb2d6f327":{"description":"Bad request — missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"message":{"type":"string","example":"Request could not be completed.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["success","message"],"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"Bad request — missing or invalid parameters"},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Bad request — missing or invalid parameters"}}},"exampleType":"examples"}},"exampleType":"examples"},"0afa352f-d0f2-47d1-bd94-f95107c8c591":{"description":"Unauthorized — missing or invalid credentials","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"message":{"type":"string","example":"Request could not be completed.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["success","message"],"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"Unauthorized — missing or invalid credentials"},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Unauthorized — missing or invalid credentials"}}},"exampleType":"examples"}},"exampleType":"examples"},"fa067f13-ff76-4afa-8170-8df390110258":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"message":{"type":"string","example":"Request could not be completed.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["success","message"],"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"Internal server error"},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Internal server error"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"dfe066b4-9ea4-4b13-bbb2-e70555399a46":{"ClientCredentials":{"type":"apiKey","in":"header","name":"client_id","scopes":[],"schemeName":"ClientCredentials"},"ClientSecret":{"type":"apiKey","in":"header","name":"client_secret","scopes":[],"schemeName":"ClientSecret"},"AccessToken":{"type":"apiKey","in":"header","name":"access_token","scopes":[],"schemeName":"AccessToken"}}},"servers":{"f56cf696-d7e1-42f2-84ed-ba4b6c59895c":{"url":"https://api.usecobalt.com/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"client_id","scopes":[],"schemeName":"ClientCredentials"},"schema":{"title":"client_id","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ClientCredentials","name":"client_id"},{"scheme":{"type":"apiKey","in":"header","name":"client_secret","scopes":[],"schemeName":"ClientSecret"},"schema":{"title":"client_secret","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ClientSecret","name":"client_secret"},{"scheme":{"type":"apiKey","in":"header","name":"access_token","scopes":[],"schemeName":"AccessToken"},"schema":{"title":"access_token","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AccessToken","name":"access_token"}],"title":"ClientCredentials \u0026 ClientSecret \u0026 AccessToken"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"cobalt-cd7844c1","siteName":"Cobalt","title":"List Telephone Encounters - Cobalt","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T23:57:23.998Z","originalFileLocation":"api-reference/telephone-encounters/list.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=\"List telephone encounters synced from the EHR, filtered by date, assignee, status and more.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cobalt\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cobalt-cd7844c1/dfAt917AjSM3D_ey/_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/cobalt-cd7844c1/dfAt917AjSM3D_ey/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cobalt-cd7844c1/dfAt917AjSM3D_ey/_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/cobalt-cd7844c1/dfAt917AjSM3D_ey/_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/cobalt-cd7844c1/dfAt917AjSM3D_ey/_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/cobalt-cd7844c1/dfAt917AjSM3D_ey/_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/cobalt-cd7844c1/dfAt917AjSM3D_ey/_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/cobalt-cd7844c1/dfAt917AjSM3D_ey/_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/cobalt-cd7844c1/dfAt917AjSM3D_ey/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Telephone Encounters - Cobalt\">\u003cmeta data-mint-head property=\"og:description\" content=\"List telephone encounters synced from the EHR, filtered by date, assignee, status and more.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cobalt\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.usecobalt.com/api-reference/telephone-encounters/list\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cobalt-cd7844c1.mintlify.app/_mintlify/api/og/v2?division=Telephone+Encounters\u0026amp;title=List+Telephone+Encounters\u0026amp;description=List+telephone+encounters+synced+from+the+EHR%2C+filtered+by+date%2C+assignee%2C+status+and+more.\u0026amp;theme=72420f10eea96853e49e9a24\u0026amp;signature=c0b9314d7f935557a2dbb7858c35b52bee14389b24347fbe7371f73a69b92062\">\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=\"List Telephone Encounters - Cobalt\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List telephone encounters synced from the EHR, filtered by date, assignee, status and more.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cobalt-cd7844c1.mintlify.app/_mintlify/api/og/v2?division=Telephone+Encounters\u0026amp;title=List+Telephone+Encounters\u0026amp;description=List+telephone+encounters+synced+from+the+EHR%2C+filtered+by+date%2C+assignee%2C+status+and+more.\u0026amp;theme=72420f10eea96853e49e9a24\u0026amp;signature=c0b9314d7f935557a2dbb7858c35b52bee14389b24347fbe7371f73a69b92062\">\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/cobalt-cd7844c1/dfAt917AjSM3D_ey/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cobalt\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#576dee\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.usecobalt.com/api-reference/telephone-encounters/list\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/telephone-encounters/list.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.usecobalt.com/#organization\",\"name\":\"Cobalt\",\"url\":\"https://docs.usecobalt.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cobalt-cd7844c1/ARV8r_xeyMO_zivG/logo/light.svg?fit=max\u0026auto=format\u0026n=ARV8r_xeyMO_zivG\u0026q=85\u0026s=de8566184dd7d19c926d1f0e5ee04d74\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.usecobalt.com#website\",\"name\":\"Cobalt\",\"url\":\"https://docs.usecobalt.com\",\"publisher\":{\"@id\":\"https://docs.usecobalt.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.usecobalt.com/api-reference/telephone-encounters/list#webpage\",\"url\":\"https://docs.usecobalt.com/api-reference/telephone-encounters/list\",\"name\":\"List Telephone Encounters\",\"description\":\"List telephone encounters synced from the EHR, filtered by date, assignee, status and more.\",\"dateModified\":\"2026-10-30T23:57:23.998Z\",\"isPartOf\":{\"@id\":\"https://docs.usecobalt.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.usecobalt.com/api-reference/telephone-encounters/list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.usecobalt.com/api-reference/telephone-encounters/list#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cobalt\",\"item\":\"https://docs.usecobalt.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Telephone Encounters\",\"item\":\"https://docs.usecobalt.com/api-reference/telephone-encounters/list\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.usecobalt.com/api-reference/telephone-encounters/list#apireference\",\"headline\":\"List Telephone Encounters\",\"name\":\"List Telephone Encounters\",\"description\":\"List telephone encounters synced from the EHR, filtered by date, assignee, status and more.\",\"url\":\"https://docs.usecobalt.com/api-reference/telephone-encounters/list\",\"mainEntityOfPage\":{\"@id\":\"https://docs.usecobalt.com/api-reference/telephone-encounters/list#webpage\"},\"dateModified\":\"2026-10-30T23:57:23.998Z\",\"publisher\":{\"@id\":\"https://docs.usecobalt.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.usecobalt.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cobalt\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Cobalt","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/docs/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Account","pages":[{"title":"Activate Account","openapi":"POST /account/activate","href":"/api-reference/account/activate"},{"title":"Deactivate Account","openapi":"POST /account/deactivate","href":"/api-reference/account/deactivate"},{"title":"Lock Client","openapi":"POST /client/lock","href":"/api-reference/account/lock"},{"title":"Rotate Access Token","openapi":"POST /access-token/rotate","href":"/api-reference/account/rotate-access-token"},{"title":"Disable Credential","openapi":"PATCH /credentials/{credentialId}/disable","href":"/api-reference/account/disable-credential"},{"title":"Enable Credential","openapi":"PATCH /credentials/{credentialId}/enable","href":"/api-reference/account/enable-credential"},{"title":"Delete Credential","openapi":"DELETE /credentials/{credentialId}","href":"/api-reference/account/delete-credential"},{"title":"Get Last Schedule Sync","openapi":"GET /last-schedule-sync","href":"/api-reference/system/last-schedule-sync"}]},{"group":"Appointments","pages":[{"title":"Create Appointments","openapi":"POST /appointments","href":"/api-reference/appointments/create"},{"title":"Fetch Appointments","openapi":"POST /appointments/fetch","href":"/api-reference/appointments/fetch"},{"title":"Get Appointments","openapi":"GET /appointments","href":"/api-reference/appointments/get"},{"title":"Get Appointment by ID","openapi":"GET /appointments/{id}","href":"/api-reference/appointments/get-by-id"},{"title":"Update Appointment","openapi":"PATCH /appointments/{id}","href":"/api-reference/appointments/update"}]},{"group":"Availability","pages":[{"title":"Fetch Availability","openapi":"POST /availability/fetch","href":"/api-reference/availability/fetch"},{"title":"Get Availability","openapi":"GET /availability","href":"/api-reference/availability/get"}]},{"group":"Claims","pages":[{"title":"Create Claim","openapi":"POST /claims","href":"/api-reference/claims/create"},{"title":"Get Claims","openapi":"GET /claims","href":"/api-reference/claims/get"},{"title":"Get Claim by ID","openapi":"GET /claims/{id}","href":"/api-reference/claims/get-by-id"},{"title":"Fetch Claims","openapi":"POST /claims/fetch","href":"/api-reference/claims/fetch"}]},{"group":"Codes","pages":[{"title":"Add Diagnosis Codes","openapi":"POST /appointments/{appointment_id}/codes","href":"/api-reference/codes/add"},{"title":"Remove Diagnosis Codes","openapi":"DELETE /appointments/{appointment_id}/codes","href":"/api-reference/codes/remove"}]},{"group":"Documents","pages":[{"title":"List Documents","openapi":"GET /documents","href":"/api-reference/documents/list"},{"title":"Fetch Document","openapi":"POST /documents/fetch","href":"/api-reference/documents/fetch"},{"title":"Get Document","openapi":"GET /documents/{id}","href":"/api-reference/documents/get"},{"title":"Upload Document","openapi":"POST /documents","href":"/api-reference/documents/upload"}]},{"group":"Eligibility","pages":[{"title":"Get Eligibility Checks","openapi":"GET /eligibility-checks","href":"/api-reference/eligibility-checks/get"},{"title":"Get Eligibility Benefits","openapi":"GET /eligibility-checks/{id}/benefits","href":"/api-reference/eligibility-checks/benefits"}]},{"group":"Fee Schedules","pages":[{"title":"Get Fee Schedules","openapi":"GET /fee-schedules","href":"/api-reference/fee-schedules/get"},{"title":"Get Fee Schedule Items","openapi":"GET /fee-schedules/{feeScheduleId}/items","href":"/api-reference/fee-schedules/items"}]},{"group":"Forms","pages":[{"title":"List Forms","openapi":"GET /forms","href":"/api-reference/forms/get"},{"title":"Get Form","openapi":"GET /forms/{id}","href":"/api-reference/forms/get-by-id"},{"title":"Sync Forms","openapi":"POST /forms/fetch","href":"/api-reference/forms/fetch"}]},{"group":"Insurance","pages":[{"title":"Get Insurance Providers","openapi":"GET /insurance-providers","href":"/api-reference/insurance-providers/get"}]},{"group":"Link","pages":[{"title":"Create Link Token","openapi":"POST /link/token/create","href":"/api-reference/link/create-token"},{"title":"Exchange Public Token","openapi":"GET /link/token/exchange","href":"/api-reference/link/exchange-token"}]},{"group":"Locations","pages":[{"title":"Get Locations","openapi":"GET /locations","href":"/api-reference/locations/get"},{"title":"Update Location Status","openapi":"PATCH /locations/{id}","href":"/api-reference/locations/update"}]},{"group":"Messages","pages":[{"title":"Send Message","openapi":"POST /messages","href":"/api-reference/messages/create"}]},{"group":"Notes","pages":[{"title":"Create Note","openapi":"POST /notes","href":"/api-reference/notes/create"}]},{"group":"Orders","pages":[{"title":"Search Order Catalog","openapi":"POST /orders/catalog/fetch","href":"/api-reference/orders/catalog"},{"title":"Create Order","openapi":"POST /orders","href":"/api-reference/orders/create"},{"title":"Get Orders","openapi":"GET /orders","href":"/api-reference/orders/get"},{"title":"Get Order","openapi":"GET /orders/{id}","href":"/api-reference/orders/get-by-id"},{"title":"Update Order","openapi":"PATCH /orders/{id}","href":"/api-reference/orders/update"},{"title":"Create Order Results","openapi":"POST /orders/{id}/results","href":"/api-reference/orders/results"}]},{"group":"Org Settings","pages":[{"title":"Fetch Org Settings","openapi":"POST /org-settings/fetch","href":"/api-reference/org-settings/fetch"}]},{"group":"Patient Notes","pages":[{"title":"Create Patient Note","openapi":"POST /patient-notes","href":"/api-reference/patient-notes/create"}]},{"group":"Patients","pages":[{"title":"Create Patient","openapi":"POST /patients","href":"/api-reference/patients/create"},{"title":"Fetch Patients","openapi":"POST /patients/fetch","href":"/api-reference/patients/fetch"},{"title":"Get Patients","openapi":"GET /patients","href":"/api-reference/patients/get"},{"title":"Update Patient","openapi":"PATCH /patients/{id}","href":"/api-reference/patients/update"},{"group":"Insurance","pages":[{"title":"Add Patient Insurance","openapi":"POST /patients/{patient_mrn}/insurances","href":"/api-reference/patients/insurances/add"},{"title":"Update Patient Insurance","openapi":"PATCH /patients/{patient_mrn}/insurances/{emr_insurance_id}","href":"/api-reference/patients/insurances/update"}]}]},{"group":"Payments","pages":[{"title":"Create Payment","openapi":"POST /payments","href":"/api-reference/payments/create"},{"title":"Get Payments","openapi":"GET /payments","href":"/api-reference/payments/get"},{"title":"Get Payment by ID","openapi":"GET /payments/{id}","href":"/api-reference/payments/get-by-id"}]},{"group":"Pharmacies","pages":[{"title":"Get Pharmacies","openapi":"GET /pharmacies","href":"/api-reference/pharmacies/get"}]},{"group":"Providers","pages":[{"title":"Get Providers","openapi":"GET /providers","href":"/api-reference/providers/get"},{"title":"Update Provider","openapi":"PATCH /providers/{id}","href":"/api-reference/providers/update"},{"title":"Update Provider by EMR ID","openapi":"PATCH /providers/ehr/{ehr_id}","href":"/api-reference/providers/update-by-ehr"}]},{"group":"Recalls","pages":[{"title":"Get Recalls","openapi":"GET /recalls","href":"/api-reference/recalls/list"},{"title":"Create Recall","openapi":"POST /recalls","href":"/api-reference/recalls/create"},{"title":"Update Recall","openapi":"PATCH /recalls/{id}","href":"/api-reference/recalls/update"},{"title":"Add Action to Recall","openapi":"POST /recalls/{id}/actions","href":"/api-reference/recalls/create-action"}]},{"group":"Referrals","pages":[{"title":"Create Referral","openapi":"POST /referrals","href":"/api-reference/referrals/create"},{"title":"Get Referrals","openapi":"GET /referrals","href":"/api-reference/referrals/get"},{"title":"Update Referral","openapi":"PATCH /referrals/{id}","href":"/api-reference/referrals/update"}]},{"group":"Referring Providers","pages":[{"title":"Create Referring Provider","openapi":"POST /referring-providers","href":"/api-reference/referring-providers/create"},{"title":"Get Referring Providers","openapi":"GET /referring-providers","href":"/api-reference/referring-providers/get"}]},{"group":"Encounters","pages":[{"title":"Create Encounter","openapi":"POST /encounters","href":"/api-reference/encounters/create"},{"title":"Update Encounter","openapi":"PATCH /encounters/{id}","href":"/api-reference/encounters/update"}]},{"group":"Settings","pages":[{"title":"Get Settings","openapi":"GET /settings","href":"/api-reference/settings/get"},{"title":"Update Settings","openapi":"POST /settings","href":"/api-reference/settings/update"}]},{"group":"Staff","pages":[{"title":"Get Staff","openapi":"GET /staff","href":"/api-reference/staff/get"}]},{"group":"Tasks","pages":[{"title":"Create Task","openapi":"POST /tasks","href":"/api-reference/tasks/create"},{"title":"Create Task Note","openapi":"POST /tasks/notes","description":"Appends a note to an existing task in the provider's EMR system.","href":"/api-reference/tasks/notes/create"}]},{"group":"Telephone Encounters","pages":[{"title":"List Telephone Encounters","openapi":"GET /telephone-encounters","href":"/api-reference/telephone-encounters/list"},{"title":"Create Telephone Encounter","openapi":"POST /telephone-encounters","description":"Creates a telephone encounter record in the provider's EMR system.","href":"/api-reference/telephone-encounters/create"},{"title":"Add Action to Telephone Encounter","openapi":"POST /telephone-encounters/actions","href":"/api-reference/telephone-encounters/create-action"}]},{"group":"Visit Statuses","pages":[{"title":"Get Visit Statuses","openapi":"GET /visit-statuses","href":"/api-reference/visit-statuses/get"}]},{"group":"Visit Types","pages":[{"title":"Get Visit Types","openapi":"GET /visit-types","href":"/api-reference/visit-types/get"}]},{"group":"Webhooks","pages":[{"title":"Create Webhook","openapi":"POST /webhook","href":"/api-reference/webhooks/create"},{"title":"Delete Webhook","openapi":"DELETE /webhook/{id}","href":"/api-reference/webhooks/delete"},{"title":"Get Webhooks","openapi":"GET /webhook","href":"/api-reference/webhooks/get"},{"title":"Rotate Webhook Secret","openapi":"POST /webhook/rotate-secret","href":"/api-reference/webhooks/rotate-secret"},{"title":"Send Test Webhook","openapi":"POST /webhook/test","href":"/api-reference/webhooks/send-test-webhook"},{"title":"Get Webhook Events","openapi":"GET /webhook-events","href":"/api-reference/webhook-events/get"},{"title":"Get Webhook Event","openapi":"GET /webhook-events/{id}","href":"/api-reference/webhook-events/get-by-id"}]}]}]},"basePath":"","title":"List Telephone Encounters - Cobalt","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}