Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
clinic_id
string<uuid>
required
referral_id
string<uuid>
required
Response
OK.
data
object
required
A clinical referral: another provider or service asks this clinic to see a patient. It is NOT the clinic referral programme (clinic-to-clinic credits for recommending ClinikEHR), the marketing "referred by" source on a client, or an antenatal or postnatal referral note. The exposed-field allow-list, field by field. review_status says where the record stands: confirmed is on the clinic's referral list; pending is an outside submission still waiting for clinic staff; rejected and withdrawn are this key's own submissions that did not become a referral. For a confirmed referral status is the clinic's workflow: it lands received, and only the clinic accepts, declines, schedules, completes or cancels it. A sender can never change status, recipient or scheduled_appointment_id. decision_reason on a confirmed referral (the clinic's reason for declining or cancelling) is shown only to the key or organization that sent it; everyone else sees null.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ClinikEHR API","description":"Reference and guides for the ClinikEHR API — read a clinic's own inventory from your own systems.","colors":{"primary":"#0D9488","light":"#2DD4BF","dark":"#0F766E"},"logo":{"light":"https://mintcdn.com/clinikehrapi/yWDcCtWZLvQferdo/logo/light.svg?fit=max\u0026auto=format\u0026n=yWDcCtWZLvQferdo\u0026q=85\u0026s=1c5da83101c773651a555abca64ef883","dark":"https://mintcdn.com/clinikehrapi/yWDcCtWZLvQferdo/logo/dark.svg?fit=max\u0026auto=format\u0026n=yWDcCtWZLvQferdo\u0026q=85\u0026s=6c05e14b5874038f79df529085e321f8","href":"https://clinikehr.com"},"favicon":"https://mintcdn.com/clinikehrapi/yWDcCtWZLvQferdo/favicon.png?fit=max\u0026auto=format\u0026n=yWDcCtWZLvQferdo\u0026q=85\u0026s=be1f63bf62da11aedb3dfd672a98f8d5","api":{"playground":{"display":"simple"},"examples":{"defaults":"all","languages":["curl","javascript","python"]}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"https://help.clinikehr.com","label":"Help Center"},{"href":"https://status.clinikehr.com","label":"Status"},{"href":"mailto:[email protected]","label":"Contact support"}],"primary":{"type":"button","label":"Open developer portal","href":"https://developer.clinikehr.com"}},"footer":{"socials":{"website":"https://clinikehr.com","x":"https://x.com/clinikehr","linkedin":"https://www.linkedin.com/company/clinikehr"},"links":[{"header":"Product","items":[{"label":"ClinikEHR","href":"https://clinikehr.com"},{"label":"Pricing","href":"https://clinikehr.com/pricing"}]},{"header":"Resources","items":[{"label":"Help Center","href":"https://help.clinikehr.com"},{"label":"Developer portal","href":"https://developer.clinikehr.com"},{"label":"Status","href":"https://status.clinikehr.com"}]},{"header":"Company","items":[{"label":"Contact support","href":"mailto:[email protected]"},{"label":"Privacy","href":"https://clinikehr.com/privacy"},{"label":"Terms","href":"https://clinikehr.com/terms"}]}]},"seo":{"metatags":{"og:site_name":"ClinikEHR API"},"indexing":"navigable"},"fonts":{"family":"Geist"},"styling":{"eyebrows":"section","codeblocks":"system","latex":false},"integrations":{"posthog":{"apiKey":"phc_817t39VWvmzFeNxvLBBOVQM0CnsuX5INS2qERVGXmIY","apiHost":"https://eu.i.posthog.com"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"clinikehrapi","hasAudioNarration":false,"actualSubdomain":"clinikehrapi","customDomains":["docs.clinikehr.com"],"gitSource":{"type":"github","owner":"clinikehr","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af297a5e44c8040cf970c65","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":121},{"language":"default","tag":"Documentation","count":48},{"language":"default","tag":"Resources","count":20},{"language":"default","tag":"Inventory","count":20},{"language":"default","tag":"HMO insurance","count":14},{"language":"default","tag":"Patients","count":11},{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"Appointments","count":8},{"language":"default","tag":"CRM","count":8},{"language":"default","tag":"Building an integration","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--ck-teal-50: #f0fdfa;--ck-teal-100: #ccfbf1;--ck-teal-500: #14b8a6;--ck-teal-600: #0d9488;--ck-teal-700: #0f766e;--ck-surface: #ffffff;--ck-surface-muted: #f8fafc;--ck-border: #e2e8f0;--ck-text: #0f172a;--ck-text-muted: #64748b;--ck-edition-clinic: #0d9488;--ck-edition-pharmacy: #7c3aed;--ck-edition-lims: #0284c7;--ck-edition-portal: #db2777}.dark{--ck-surface: #0b1120;--ck-surface-muted: #111827;--ck-border: #1f2937;--ck-text: #e2e8f0;--ck-text-muted: #94a3b8;--ck-edition-clinic: #2dd4bf;--ck-edition-pharmacy: #a78bfa;--ck-edition-lims: #38bdf8;--ck-edition-portal: #f472b6}.ck-avail{display:flex;flex-wrap:wrap;align-items:center;gap:0.5rem;margin:1.25rem 0 1.75rem;padding:0.75rem 0.9rem;border:1px solid var(--ck-border);border-radius:0.75rem;background:var(--ck-surface-muted);font-size:0.8125rem;line-height:1.4}.ck-avail__label{font-weight:600;color:var(--ck-text-muted);text-transform:uppercase;letter-spacing:0.04em;font-size:0.6875rem;margin-right:0.15rem}.ck-pill{display:inline-flex;align-items:center;gap:0.35rem;padding:0.2rem 0.6rem;border-radius:999px;border:1px solid currentColor;font-weight:600;font-size:0.75rem;white-space:nowrap}.ck-pill--clinic{color:var(--ck-edition-clinic)}.ck-pill--pharmacy{color:var(--ck-edition-pharmacy)}.ck-pill--lims{color:var(--ck-edition-lims)}.ck-pill--portal{color:var(--ck-edition-portal)}.ck-pill--plan{color:var(--ck-text-muted);border-style:dashed}.ck-pill--role{color:var(--ck-text-muted);border-color:var(--ck-border);background:var(--ck-surface)}.ck-avail__note{flex-basis:100%;color:var(--ck-text-muted)}.ck-callout{margin:1.5rem 0;padding:0.9rem 1rem;border-radius:0.75rem;border:1px solid var(--ck-border);border-left-width:3px;background:var(--ck-surface-muted)}.ck-callout--note{border-left-color:var(--ck-teal-600)}.ck-callout--info{border-left-color:#6366f1}.dark .ck-callout--note{border-left-color:var(--ck-teal-500)}.dark .ck-callout--info{border-left-color:#818cf8}.ck-callout__body{margin:0;font-size:0.9375rem;line-height:1.6;color:var(--ck-text)}.ck-callout__body a{color:var(--ck-teal-700);text-decoration:underline;text-underline-offset:2px}.dark .ck-callout__body a{color:var(--ck-teal-500)}.ck-task{display:grid;gap:0.75rem;grid-template-columns:repeat(auto-fit, minmax(220px, 1fr));margin:1.5rem 0}.ck-task__cell{border:1px solid var(--ck-border);border-radius:0.75rem;padding:0.85rem 1rem;background:var(--ck-surface)}.ck-task__title{font-size:0.6875rem;font-weight:700;letter-spacing:0.06em;text-transform:uppercase;color:var(--ck-teal-600);margin-bottom:0.35rem}.dark .ck-task__title{color:var(--ck-teal-500)}.ck-task__body{font-size:0.875rem;color:var(--ck-text);margin:0}.ck-path{display:inline-flex;flex-wrap:wrap;align-items:center;gap:0.35rem;padding:0.3rem 0.6rem;border-radius:0.5rem;background:var(--ck-teal-50);border:1px solid var(--ck-teal-100);font-size:0.8125rem;font-weight:500;color:var(--ck-teal-700)}.dark .ck-path{background:rgba(13, 148, 136, 0.12);border-color:rgba(45, 212, 191, 0.28);color:var(--ck-teal-500)}.ck-path__sep{opacity:0.55}#sidebar li>a,#sidebar li>div{font-size:0.8125rem}#content-area a[href]>div.group,#content-area .card{transition:transform 150ms ease, box-shadow 150ms ease, border-color 150ms ease}#content-area a[href]:hover>div.group,#content-area .card:hover{transform:translateY(-2px);box-shadow:0 8px 24px -12px rgba(15, 23, 42, 0.25);border-color:var(--ck-teal-500)}.dark #content-area a[href]:hover>div.group,.dark #content-area .card:hover{box-shadow:0 8px 24px -12px rgba(0, 0, 0, 0.6)}#content-area table{display:block;overflow-x:auto;max-width:100%}#content-area thead th{font-size:0.75rem;text-transform:uppercase;letter-spacing:0.04em;color:var(--ck-text-muted)}#content-area .steps .step-number,#content-area [class*=\"step\"]>div[class*=\"rounded-full\"]{background-color:var(--ck-teal-600);color:#fff}@media (max-width: 768px){#content-area table{font-size:0.8125rem}#content-area th,#content-area td{padding-left:0.6rem;padding-right:0.6rem}}@media (max-width: 640px){.ck-avail{padding:0.6rem 0.7rem;gap:0.4rem;font-size:0.78rem}.ck-pill{padding:0.15rem 0.5rem;font-size:0.7rem}.ck-task{grid-template-columns:1fr;gap:0.5rem}.ck-task__cell{padding:0.7rem 0.85rem}.ck-path{font-size:0.78rem;line-height:1.9}.ck-callout{padding:0.75rem 0.85rem;margin:1.1rem 0}}@media (pointer: coarse){#content-area .card,#content-area a[href]>div.group{min-height:44px}#sidebar li>a{padding-top:0.45rem;padding-bottom:0.45rem}}"}]}
{"page":{"pagePath":"api-reference/referrals/get-a-referral","slug":"/api-reference/referrals/get-a-referral","pageMetadata":{"title":"Get a referral","description":"**Permission:** `referrals:read`\n\nGet one referral from the clinic's list.\n\nOnly a confirmed referral is fetchable by id. With `Accept: application/fhir+json` the answer is a FHIR R4 ServiceRequest.","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/referrals/{referral_id}","href":"/api-reference/referrals/get-a-referral","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Permission:\"\n }), \" \", _jsx(_components.code, {\n children: \"referrals:read\"\n })]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Get one referral from the clinic’s list.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Only a confirmed referral is fetchable by id. With \", _jsx(_components.code, {\n children: \"Accept: application/fhir+json\"\n }), \" the answer is a FHIR R4 ServiceRequest.\"]\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 referral","description":"**Permission:** `referrals:read`\n\nGet one referral from the clinic's list.\n\nOnly a confirmed referral is fetchable by id. With `Accept: application/fhir+json` the answer is a FHIR R4 ServiceRequest.","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/referrals/{referral_id}","href":"/api-reference/referrals/get-a-referral","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getReferral","tags":["Referrals"],"summary":"Get a referral","description":"**Permission:** `referrals:read`\n\nGet one referral from the clinic's list.\n\nOnly a confirmed referral is fetchable by id. With `Accept: application/fhir+json` the answer is a FHIR R4 ServiceRequest.","security":["3ce76155-c9dd-444e-b818-ce8e2bec5100"],"parameters":["90240cc9-d241-42c8-b066-c4e0103cf411","e488b539-807d-441c-ae7d-a09958bd841b"],"responses":{"200":"39b7b93e-feaf-4d4a-b8d6-51adafa3c3d5","400":"72639e7e-93dc-4074-8beb-cd554e24a1e6","401":"ea4f805c-82ec-4427-b3c9-bbb0b2a2263a","403":"4c552136-32f4-4a99-8de7-ac1d61ee8fbe","404":"7f98c266-5f08-400a-bbcc-a092cc992a04","429":"f114226d-b0c4-4303-ae22-59773fea5375"},"method":"get","type":"path","servers":["6b4925f0-63ab-4b39-afe9-988d83d8bf2e"],"path":"/v1/clinics/{clinic_id}/referrals/{referral_id}","baseUrlOptions":["https://api.clinikehr.com"],"title":"Get a referral","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"90240cc9-d241-42c8-b066-c4e0103cf411":{"name":"clinic_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}},"e488b539-807d-441c-ae7d-a09958bd841b":{"name":"referral_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"39b7b93e-feaf-4d4a-b8d6-51adafa3c3d5":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","description":"A clinical referral: another provider or service asks this clinic to see a patient. It is NOT the clinic referral programme (clinic-to-clinic credits for recommending ClinikEHR), the marketing \"referred by\" source on a client, or an antenatal or postnatal referral note. The exposed-field allow-list, field by field. `review_status` says where the record stands: `confirmed` is on the clinic's referral list; `pending` is an outside submission still waiting for clinic staff; `rejected` and `withdrawn` are this key's own submissions that did not become a referral. For a confirmed referral `status` is the clinic's workflow: it lands `received`, and only the clinic accepts, declines, schedules, completes or cancels it. A sender can never change `status`, `recipient` or `scheduled_appointment_id`. `decision_reason` on a confirmed referral (the clinic's reason for declining or cancelling) is shown only to the key or organization that sent it; everyone else sees null.","required":["id","patient_id","direction","status","service","reason","review_status"],"properties":{"id":{"oneOf":[{"type":"string","format":"uuid","description":"The referral's id once confirmed; null for a pending create (use `submission_id`). A pending update or retraction carries the id of the referral it targets.","isRequired":true,"uniqueKey":"data.id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"The referral's id once confirmed; null for a pending create (use `submission_id`). A pending update or retraction carries the id of the referral it targets.","isRequired":true,"uniqueKey":"data.id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.id","typeLabel":"string\u003cuuid> | null"},"patient_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.patient_id","typeLabel":"string\u003cuuid>"},"direction":{"oneOf":[{"type":"string","enum":["incoming","outgoing",null],"description":"`incoming` is a referral to this clinic. Only `incoming` is written today.","isRequired":true,"uniqueKey":"data.direction.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["incoming","outgoing",null],"description":"`incoming` is a referral to this clinic. Only `incoming` is written today.","isRequired":true,"uniqueKey":"data.direction.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.direction","typeLabel":"enum\u003cstring> | null"},"status":{"oneOf":[{"type":"string","enum":["received","accepted","scheduled","completed","declined","cancelled","entered_in_error",null],"description":"The clinic's workflow state. Null for a pending submission.","isRequired":true,"uniqueKey":"data.status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["received","accepted","scheduled","completed","declined","cancelled","entered_in_error",null],"description":"The clinic's workflow state. Null for a pending submission.","isRequired":true,"uniqueKey":"data.status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring> | null"},"service":{"type":"object","required":["text"],"properties":{"text":{"oneOf":[{"type":"string","description":"What is being asked for, as the sender states it.","isRequired":true,"uniqueKey":"data.service.text.oneOf.0","typeLabel":"string"},{"type":"null","description":"What is being asked for, as the sender states it.","isRequired":true,"uniqueKey":"data.service.text.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.service.text","typeLabel":"string | null"},"code":{"oneOf":[{"type":"object","description":"A coded service. `system` is `snomed-ct` (a SNOMED CT concept id, 6 to 18 digits; the platform holds no SNOMED corpus, so only its shape is checked) or `local` (your own code, never mapped to a standard).","required":["system","code"],"properties":{"system":{"type":"string","enum":["snomed-ct","local"],"isRequired":true,"uniqueKey":"data.service.code.oneOf.0.system","typeLabel":"enum\u003cstring>"},"code":{"type":"string","isRequired":true,"uniqueKey":"data.service.code.oneOf.0.code","typeLabel":"string"}},"uniqueKey":"data.service.code.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.service.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.service.code","typeLabel":"object | null"}},"isRequired":true,"uniqueKey":"data.service","typeLabel":"object"},"reason":{"type":"object","required":["text"],"properties":{"text":{"oneOf":[{"type":"string","description":"Why the patient is being referred, as the sender states it.","isRequired":true,"uniqueKey":"data.reason.text.oneOf.0","typeLabel":"string"},{"type":"null","description":"Why the patient is being referred, as the sender states it.","isRequired":true,"uniqueKey":"data.reason.text.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.reason.text","typeLabel":"string | null"},"code":{"oneOf":[{"type":"object","description":"A coded reason. `system` is `icd-10-cm` or `icd-10` (checked against the platform's own diagnosis codes and stored in canonical form; an unrecognised code is refused), `snomed-ct` (6 to 18 digits, shape only) or `local` (your own code, never mapped to a standard).","required":["system","code"],"properties":{"system":{"type":"string","enum":["icd-10-cm","icd-10","snomed-ct","local"],"isRequired":true,"uniqueKey":"data.reason.code.oneOf.0.system","typeLabel":"enum\u003cstring>"},"code":{"type":"string","isRequired":true,"uniqueKey":"data.reason.code.oneOf.0.code","typeLabel":"string"}},"uniqueKey":"data.reason.code.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.reason.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.reason.code","typeLabel":"object | null"}},"isRequired":true,"uniqueKey":"data.reason","typeLabel":"object"},"review_status":{"type":"string","enum":["confirmed","pending","rejected","withdrawn"],"isRequired":true,"uniqueKey":"data.review_status","typeLabel":"enum\u003cstring>"},"priority":{"oneOf":[{"type":"string","enum":["routine","urgent","asap","stat",null],"uniqueKey":"data.priority.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["routine","urgent","asap","stat",null],"uniqueKey":"data.priority.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.priority","typeLabel":"enum\u003cstring> | null"},"clinical_summary":{"oneOf":[{"type":"string","uniqueKey":"data.clinical_summary.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.clinical_summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.clinical_summary","typeLabel":"string | null"},"requester":{"type":"object","description":"Who sent the referral, as the sender states it. Nothing here is checked against a directory.","properties":{"name":{"oneOf":[{"type":"string","uniqueKey":"data.requester.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.requester.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.requester.name","typeLabel":"string | null"},"organization":{"oneOf":[{"type":"string","uniqueKey":"data.requester.organization.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.requester.organization.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.requester.organization","typeLabel":"string | null"},"npi":{"oneOf":[{"type":"string","description":"Ten digits.","uniqueKey":"data.requester.npi.oneOf.0","typeLabel":"string"},{"type":"null","description":"Ten digits.","uniqueKey":"data.requester.npi.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.requester.npi","typeLabel":"string | null"}},"uniqueKey":"data.requester","typeLabel":"object"},"recipient":{"type":"object","description":"Who at the clinic will see the patient. Set by clinic staff when they accept the referral; never by a sender.","properties":{"provider_id":{"oneOf":[{"type":"string","format":"uuid","description":"A provider `id` from `listProviders`.","uniqueKey":"data.recipient.provider_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"A provider `id` from `listProviders`.","uniqueKey":"data.recipient.provider_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.recipient.provider_id","typeLabel":"string\u003cuuid> | null"},"department_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"data.recipient.department_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"data.recipient.department_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.recipient.department_id","typeLabel":"string\u003cuuid> | null"}},"uniqueKey":"data.recipient","typeLabel":"object"},"requested_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.requested_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.requested_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.requested_at","typeLabel":"string\u003cdate-time> | null"},"needed_by":{"oneOf":[{"type":"string","format":"date","uniqueKey":"data.needed_by.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","uniqueKey":"data.needed_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.needed_by","typeLabel":"string\u003cdate> | null"},"scheduled_appointment_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"data.scheduled_appointment_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"data.scheduled_appointment_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.scheduled_appointment_id","typeLabel":"string\u003cuuid> | null"},"source":{"oneOf":[{"type":"string","enum":["clinic","api",null],"uniqueKey":"data.source.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["clinic","api",null],"uniqueKey":"data.source.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.source","typeLabel":"enum\u003cstring> | null"},"origin_assistant_name":{"oneOf":[{"type":"string","uniqueKey":"data.origin_assistant_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.origin_assistant_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.origin_assistant_name","typeLabel":"string | null"},"accepted_by":{"oneOf":[{"type":"string","enum":["clinic","automatic",null],"description":"Who put this record on the chart: `clinic` (the clinic's own team, or a clinician who confirmed it) or `automatic` (the clinic chose to accept this kind of item from this key or connection without review; the record is on the chart but no clinician has reviewed it, so `verification_status` reads `unconfirmed` until one does). Null while the item is still a pending submission.","uniqueKey":"data.accepted_by.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["clinic","automatic",null],"description":"Who put this record on the chart: `clinic` (the clinic's own team, or a clinician who confirmed it) or `automatic` (the clinic chose to accept this kind of item from this key or connection without review; the record is on the chart but no clinician has reviewed it, so `verification_status` reads `unconfirmed` until one does). Null while the item is still a pending submission.","uniqueKey":"data.accepted_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.accepted_by","typeLabel":"enum\u003cstring> | null"},"reviewed_at":{"oneOf":[{"type":"string","format":"date-time","description":"Set when a clinician marked an automatically accepted item reviewed; null otherwise.","uniqueKey":"data.reviewed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Set when a clinician marked an automatically accepted item reviewed; null otherwise.","uniqueKey":"data.reviewed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.reviewed_at","typeLabel":"string\u003cdate-time> | null"},"reviewed_by_staff_id":{"oneOf":[{"type":"string","format":"uuid","description":"clinic_staff.id of the clinician who marked an automatically accepted item reviewed; null otherwise.","uniqueKey":"data.reviewed_by_staff_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"clinic_staff.id of the clinician who marked an automatically accepted item reviewed; null otherwise.","uniqueKey":"data.reviewed_by_staff_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.reviewed_by_staff_id","typeLabel":"string\u003cuuid> | null"},"submission_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"data.submission_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"data.submission_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.submission_id","typeLabel":"string\u003cuuid> | null"},"decision_reason":{"oneOf":[{"type":"string","description":"On a rejected submission, why clinic staff rejected it. On a confirmed referral, the clinic's reason for declining or cancelling - shown only to the key or organization that sent it.","uniqueKey":"data.decision_reason.oneOf.0","typeLabel":"string"},{"type":"null","description":"On a rejected submission, why clinic staff rejected it. On a confirmed referral, the clinic's reason for declining or cancelling - shown only to the key or organization that sent it.","uniqueKey":"data.decision_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.decision_reason","typeLabel":"string | null"},"created_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time> | null"},"updated_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time> | null"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","patient_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","direction":"incoming","status":"received","service":{"text":"\u003cstring>","code":{"system":"snomed-ct","code":"\u003cstring>"}},"reason":{"text":"\u003cstring>","code":{"system":"icd-10-cm","code":"\u003cstring>"}},"review_status":"confirmed","priority":"routine","clinical_summary":"\u003cstring>","requester":{"name":"\u003cstring>","organization":"\u003cstring>","npi":"\u003cstring>"},"recipient":{"provider_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","department_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"},"requested_at":"2023-11-07T05:31:56Z","needed_by":"2023-12-25","scheduled_appointment_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","source":"clinic","origin_assistant_name":"\u003cstring>","accepted_by":"clinic","reviewed_at":"2023-11-07T05:31:56Z","reviewed_by_staff_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","submission_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","decision_reason":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"72639e7e-93dc-4074-8beb-cd554e24a1e6":{"description":"The request failed validation (unknown query parameter, limit out of range, malformed body, a write-off sent without its reason — `reason_required`, or a `gtin` identifier that is not a valid GTIN — `invalid_gtin`).","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 application/problem+json.","required":["type","title","status","code","request_id"],"properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["pointer","message"],"properties":{"pointer":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"code":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>","errors":[{"pointer":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"ea4f805c-82ec-4427-b3c9-bbb0b2a2263a":{"description":"Missing, malformed, unknown, revoked or expired key, or the wrong secret.","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 application/problem+json.","required":["type","title","status","code","request_id"],"properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["pointer","message"],"properties":{"pointer":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"code":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>","errors":[{"pointer":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"4c552136-32f4-4a99-8de7-ac1d61ee8fbe":{"description":"The key or connection lacks the required scope, the plan does not include this resource, the request came from an address this key's IP allow-list does not permit, a TEST-environment workspace key asked for a clinic_id other than its own workspace's sandbox (`sandbox_only`), or a LIVE workspace key asked for a real clinic while its workspace's verification has lapsed (`not_verified`) — the response never names which addresses ARE allowed, nor which clinic actually is the sandbox.","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 application/problem+json.","required":["type","title","status","code","request_id"],"properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["pointer","message"],"properties":{"pointer":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"code":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>","errors":[{"pointer":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"7f98c266-5f08-400a-bbcc-a092cc992a04":{"description":"The record is absent, or out of the key's scope — one message for both.","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 application/problem+json.","required":["type","title","status","code","request_id"],"properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["pointer","message"],"properties":{"pointer":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"code":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>","errors":[{"pointer":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"f114226d-b0c4-4303-ae22-59773fea5375":{"description":"Rate limited. See the Retry-After header.","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 application/problem+json.","required":["type","title","status","code","request_id"],"properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["pointer","message"],"properties":{"pointer":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"code":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>","errors":[{"pointer":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"3ce76155-c9dd-444e-b818-ce8e2bec5100":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"ehr_live_\u003ckeyId>_\u003csecret> or ehr_test_\u003ckeyId>_\u003csecret>","scopes":[],"schemeName":"ApiKey"}}},"servers":{"6b4925f0-63ab-4b39-afe9-988d83d8bf2e":{"url":"https://api.clinikehr.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"ehr_live_\u003ckeyId>_\u003csecret> or ehr_test_\u003ckeyId>_\u003csecret>","scopes":[],"schemeName":"ApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKey","name":"Authorization"}],"title":"ApiKey"}]},"originalFileLocation":"openapi/ehr-api.v1.yaml"},"subdomain":"clinikehrapi","siteName":"ClinikEHR API","title":"Get a referral - ClinikEHR API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-01T00:01:38.296Z","originalFileLocation":"api-reference/referrals/get-a-referral.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=\"Permission: referrals:read Get one referral from the clinic\u0026#x27;s list. Only a confirmed referral is fetchable by id. With Accept: application/fhir+json the answer is a FHIR R4 ServiceRequest.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ClinikEHR API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/clinikehrapi/7-ZhjGEqSsWHGBLc/_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/clinikehrapi/7-ZhjGEqSsWHGBLc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/clinikehrapi/7-ZhjGEqSsWHGBLc/_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/clinikehrapi/7-ZhjGEqSsWHGBLc/_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/clinikehrapi/7-ZhjGEqSsWHGBLc/_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/clinikehrapi/7-ZhjGEqSsWHGBLc/_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/clinikehrapi/7-ZhjGEqSsWHGBLc/_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/clinikehrapi/7-ZhjGEqSsWHGBLc/_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/clinikehrapi/7-ZhjGEqSsWHGBLc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a referral - ClinikEHR API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Permission: referrals:read Get one referral from the clinic\u0026#x27;s list. Only a confirmed referral is fetchable by id. With Accept: application/fhir+json the answer is a FHIR R4 ServiceRequest.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ClinikEHR API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.clinikehr.com/api-reference/referrals/get-a-referral\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://clinikehrapi.mintlify.site/_mintlify/api/og/v2?division=Referrals\u0026amp;title=Get+a+referral\u0026amp;description=**Permission%3A**+%60referrals%3Aread%60%0A%0AGet+one+referral+from+the+clinic%27s+list.%0A%0AOnly+a+confirmed+referral+is+fetchable+by+id.+With+%60Accept%3A+application%2Ffhir%2Bjson%60+t\u0026amp;theme=db10b84d30f87e3825f88ac9\u0026amp;signature=5afccaf7fffa45b4ff01b55d0ebe7d6ded81321c0c5af1a03e3bfbf772099bc5\">\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 referral - ClinikEHR API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Permission: referrals:read Get one referral from the clinic\u0026#x27;s list. Only a confirmed referral is fetchable by id. With Accept: application/fhir+json the answer is a FHIR R4 ServiceRequest.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://clinikehrapi.mintlify.site/_mintlify/api/og/v2?division=Referrals\u0026amp;title=Get+a+referral\u0026amp;description=**Permission%3A**+%60referrals%3Aread%60%0A%0AGet+one+referral+from+the+clinic%27s+list.%0A%0AOnly+a+confirmed+referral+is+fetchable+by+id.+With+%60Accept%3A+application%2Ffhir%2Bjson%60+t\u0026amp;theme=db10b84d30f87e3825f88ac9\u0026amp;signature=5afccaf7fffa45b4ff01b55d0ebe7d6ded81321c0c5af1a03e3bfbf772099bc5\">\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/clinikehrapi/7-ZhjGEqSsWHGBLc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ClinikEHR API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9488\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.clinikehr.com/api-reference/referrals/get-a-referral\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/referrals/get-a-referral.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.clinikehr.com/#organization\",\"name\":\"ClinikEHR API\",\"url\":\"https://docs.clinikehr.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/clinikehrapi/yWDcCtWZLvQferdo/logo/light.svg?fit=max\u0026auto=format\u0026n=yWDcCtWZLvQferdo\u0026q=85\u0026s=1c5da83101c773651a555abca64ef883\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.clinikehr.com#website\",\"name\":\"ClinikEHR API\",\"url\":\"https://docs.clinikehr.com\",\"publisher\":{\"@id\":\"https://docs.clinikehr.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.clinikehr.com/api-reference/referrals/get-a-referral#webpage\",\"url\":\"https://docs.clinikehr.com/api-reference/referrals/get-a-referral\",\"name\":\"Get a referral\",\"description\":\"Permission: referrals:read Get one referral from the clinic's list. Only a confirmed referral is fetchable by id. With Accept: application/fhir+json the answer is a FHIR R4 ServiceRequest.\",\"dateModified\":\"2026-11-01T00:01:38.296Z\",\"isPartOf\":{\"@id\":\"https://docs.clinikehr.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.clinikehr.com/api-reference/referrals/get-a-referral#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.clinikehr.com/api-reference/referrals/get-a-referral#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Referrals\",\"item\":\"https://docs.clinikehr.com/api-reference/referrals/list-referrals\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a referral\",\"item\":\"https://docs.clinikehr.com/api-reference/referrals/get-a-referral\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.clinikehr.com/api-reference/referrals/get-a-referral#apireference\",\"headline\":\"Get a referral\",\"name\":\"Get a referral\",\"description\":\"Permission: referrals:read Get one referral from the clinic's list. Only a confirmed referral is fetchable by id. With Accept: application/fhir+json the answer is a FHIR R4 ServiceRequest.\",\"url\":\"https://docs.clinikehr.com/api-reference/referrals/get-a-referral\",\"mainEntityOfPage\":{\"@id\":\"https://docs.clinikehr.com/api-reference/referrals/get-a-referral#webpage\"},\"dateModified\":\"2026-11-01T00:01:38.296Z\",\"publisher\":{\"@id\":\"https://docs.clinikehr.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.clinikehr.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ClinikEHR API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ClinikEHR API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/referrals/get-a-referral.md","siteName":"ClinikEHR API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API reference","icon":"https://mintlify.s3.us-west-1.amazonaws.com/clinikehrapi/images/icons/code.svg","href":"/api-reference/overview"}]},{"group":"Your key","pages":[{"title":"Get the current key","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/me","href":"/api-reference/me/get-the-current-key"}]},{"group":"Connections","pages":[{"title":"List connections","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/connections","href":"/api-reference/connections/list-connections"}]},{"group":"Patients","pages":[{"title":"List patients","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/patients","href":"/api-reference/patients/list-patients"},{"title":"Create a patient","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/patients","href":"/api-reference/patients/create-a-patient"},{"title":"Get a patient","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/patients/{patient_id}","href":"/api-reference/patients/get-a-patient"},{"title":"Update a patient","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml patch /v1/clinics/{clinic_id}/patients/{patient_id}","href":"/api-reference/patients/update-a-patient"},{"title":"Archive a patient","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/patients/{patient_id}/archive","href":"/api-reference/patients/archive-a-patient"},{"title":"List possible duplicate patients","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/patients/duplicate_flags","href":"/api-reference/patients/list-possible-duplicate-patients"},{"title":"Search patients","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/patients/search","href":"/api-reference/patients/search-patients"},{"title":"List patient imports","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/patient-imports","href":"/api-reference/patients/list-patient-imports"},{"title":"Start a patient import","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/patient-imports","href":"/api-reference/patients/start-a-patient-import"},{"title":"Get a patient import","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/patient-imports/{job_id}","href":"/api-reference/patients/get-a-patient-import"},{"title":"Import the valid rows","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/patient-imports/{job_id}/run-valid","href":"/api-reference/patients/import-the-valid-rows"}]},{"group":"Appointments","pages":[{"title":"List bookable services","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/appointments/services","href":"/api-reference/appointments/list-bookable-services"},{"title":"List bookable clinicians","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/appointments/clinicians","href":"/api-reference/appointments/list-bookable-clinicians"},{"title":"Get available slots","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/appointments/availability","href":"/api-reference/appointments/get-available-slots"},{"title":"List appointments","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/appointments","href":"/api-reference/appointments/list-appointments"},{"title":"Book an appointment","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/appointments","href":"/api-reference/appointments/book-an-appointment"},{"title":"Get an appointment","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/appointments/{appointment_id}","href":"/api-reference/appointments/get-an-appointment"},{"title":"Update an appointment","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml patch /v1/clinics/{clinic_id}/appointments/{appointment_id}","href":"/api-reference/appointments/update-an-appointment"},{"title":"Cancel an appointment","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/appointments/{appointment_id}/cancel","href":"/api-reference/appointments/cancel-an-appointment"}]},{"group":"Encounters","pages":[{"title":"List encounters","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/encounters","href":"/api-reference/encounters/list-encounters"},{"title":"Open an encounter","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/encounters","href":"/api-reference/encounters/open-an-encounter"},{"title":"Get an encounter","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/encounters/{encounter_id}","href":"/api-reference/encounters/get-an-encounter"},{"title":"Update an encounter","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml patch /v1/clinics/{clinic_id}/encounters/{encounter_id}","href":"/api-reference/encounters/update-an-encounter"}]},{"group":"Notes","pages":[{"title":"List notes","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/notes","href":"/api-reference/notes/list-notes"},{"title":"Create a draft note","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/notes","href":"/api-reference/notes/create-a-draft-note"},{"title":"Get a note","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/notes/{note_id}","href":"/api-reference/notes/get-a-note"},{"title":"Update a draft note","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml patch /v1/clinics/{clinic_id}/notes/{note_id}","href":"/api-reference/notes/update-a-draft-note"},{"title":"List note templates","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/note-templates","href":"/api-reference/notes/list-note-templates"},{"title":"Get a note template","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/note-templates/{template_key}","href":"/api-reference/notes/get-a-note-template"},{"title":"List note clinicians","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/note-clinicians","href":"/api-reference/notes/list-note-clinicians"}]},{"group":"Conditions","pages":[{"title":"List conditions","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/conditions","href":"/api-reference/conditions/list-conditions"},{"title":"Submit a condition","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/conditions","href":"/api-reference/conditions/submit-a-condition"},{"title":"Get a condition","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/conditions/{condition_id}","href":"/api-reference/conditions/get-a-condition"},{"title":"Update or retract a condition","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml patch /v1/clinics/{clinic_id}/conditions/{condition_id}","href":"/api-reference/conditions/update-or-retract-a-condition"}]},{"group":"Allergies","pages":[{"title":"List allergies","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/allergies","href":"/api-reference/allergies/list-allergies"},{"title":"Submit an allergy","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/allergies","href":"/api-reference/allergies/submit-an-allergy"},{"title":"Get an allergy","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/allergies/{allergy_id}","href":"/api-reference/allergies/get-an-allergy"},{"title":"Update or retract an allergy","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml patch /v1/clinics/{clinic_id}/allergies/{allergy_id}","href":"/api-reference/allergies/update-or-retract-an-allergy"}]},{"group":"Medications","pages":[{"title":"List reported medicines","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/medication-statements","href":"/api-reference/medications/list-reported-medicines"},{"title":"Submit a reported medicine","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/medication-statements","href":"/api-reference/medications/submit-a-reported-medicine"},{"title":"Get a reported medicine","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/medication-statements/{medication_statement_id}","href":"/api-reference/medications/get-a-reported-medicine"},{"title":"Update or retract a reported medicine","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml patch /v1/clinics/{clinic_id}/medication-statements/{medication_statement_id}","href":"/api-reference/medications/update-or-retract-a-reported-medicine"},{"title":"List prescriptions","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/prescriptions","href":"/api-reference/medications/list-prescriptions"},{"title":"Get a prescription","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/prescriptions/{prescription_id}","href":"/api-reference/medications/get-a-prescription"}]},{"group":"Referrals","pages":[{"title":"List referrals","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/referrals","href":"/api-reference/referrals/list-referrals"},{"title":"Submit a referral","description":"**Permission:** `referrals:write`\n\nSubmit a referral to the clinic for its staff to confirm.\n\nThe referral is held for review and answers 202 Accepted with a `Location` header pointing at the submission; it is not on the clinic's referral list until staff confirm it (unless the clinic has chosen to accept such submissions automatically). Confirming adds it as `received` - it does not accept the referral or book anything; the clinic decides that next, and a sender cannot. The `Idempotency-Key` header is REQUIRED - a retry with the same key returns the original submission, never a second one. This is a clinical referral, not the clinic referral programme. JSON only: a FHIR ServiceRequest body is not accepted.","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/referrals","href":"/api-reference/referrals/submit-a-referral"},{"title":"Get a referral","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/referrals/{referral_id}","href":"/api-reference/referrals/get-a-referral"},{"title":"Update or retract a referral","description":"**Permission:** `referrals:write`\n\nPropose a change to a referral you sent, or retract it.\n\nThe change is held for clinic staff to confirm and answers 202 Accepted with a `Location` header pointing at the new submission; the referral is unchanged until then. You can change a referral only while the clinic has not acted on it (`status: received`); after staff accept, decline, schedule, complete or cancel it, the request is refused with a 400 saying the clinic has already actioned it. `status: entered_in_error` proposes a retraction, also only while `received`. A sender cannot accept, decline, schedule, complete or cancel a referral. The service cannot be changed. The `Idempotency-Key` header is optional. JSON only: a FHIR ServiceRequest body is not accepted.","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml patch /v1/clinics/{clinic_id}/referrals/{referral_id}","href":"/api-reference/referrals/update-or-retract-a-referral"}]},{"group":"Submissions","pages":[{"title":"Get a submission","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/submissions/{submission_id}","href":"/api-reference/submissions/get-a-submission"}]},{"group":"Providers","pages":[{"title":"List providers","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/providers","href":"/api-reference/providers/list-providers"},{"title":"Get a provider","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/providers/{provider_id}","href":"/api-reference/providers/get-a-provider"}]},{"group":"Care providers","pages":[{"title":"List outside care providers","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/care-providers","href":"/api-reference/careproviders/list-outside-care-providers"},{"title":"Add an outside care provider","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/care-providers","href":"/api-reference/careproviders/add-an-outside-care-provider"},{"title":"Get an outside care provider","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/care-providers/{care_provider_id}","href":"/api-reference/careproviders/get-an-outside-care-provider"},{"title":"Update an outside care provider","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml patch /v1/clinics/{clinic_id}/care-providers/{care_provider_id}","href":"/api-reference/careproviders/update-an-outside-care-provider"},{"title":"Remove an outside care provider","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml delete /v1/clinics/{clinic_id}/care-providers/{care_provider_id}","href":"/api-reference/careproviders/remove-an-outside-care-provider"}]},{"group":"Insurance payers","pages":[{"title":"List payers","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/payers","href":"/api-reference/payers/list-payers"},{"title":"Get a payer","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/payers/{payer_id}","href":"/api-reference/payers/get-a-payer"}]},{"group":"Insurance coverage","pages":[{"title":"List coverages","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/coverages","href":"/api-reference/coverages/list-coverages"},{"title":"Create a coverage","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/coverages","href":"/api-reference/coverages/create-a-coverage"},{"title":"Get a coverage","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/coverages/{coverage_id}","href":"/api-reference/coverages/get-a-coverage"},{"title":"Update or end a coverage","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml patch /v1/clinics/{clinic_id}/coverages/{coverage_id}","href":"/api-reference/coverages/update-or-end-a-coverage"}]},{"group":"HMO insurance","pages":[{"title":"List insurer enrollees","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/insurance/enrollees","href":"/api-reference/hmo-insurance/list-insurer-enrollees"},{"title":"Get an insurer enrollee","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/insurance/enrollees/{enrollee_id}","href":"/api-reference/hmo-insurance/get-an-insurer-enrollee"},{"title":"List insurer plans","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/insurance/plans","href":"/api-reference/hmo-insurance/list-insurer-plans"},{"title":"Get an insurer plan","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/insurance/plans/{plan_id}","href":"/api-reference/hmo-insurance/get-an-insurer-plan"},{"title":"List insurer claims","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/insurance/claims","href":"/api-reference/hmo-insurance/list-insurer-claims"},{"title":"Submit an insurance claim","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/insurance/claims","href":"/api-reference/hmo-insurance/submit-an-insurance-claim"},{"title":"Get an insurer claim","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/insurance/claims/{claim_id}","href":"/api-reference/hmo-insurance/get-an-insurer-claim"},{"title":"Vet an insurance claim","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/insurance/claims/{claim_id}/adjudication","href":"/api-reference/hmo-insurance/vet-an-insurance-claim"},{"title":"List pre-authorization requests","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/insurance/pre-authorizations","href":"/api-reference/hmo-insurance/list-pre-authorization-requests"},{"title":"Send a pre-authorization request","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/insurance/pre-authorizations","href":"/api-reference/hmo-insurance/send-a-pre-authorization-request"},{"title":"Get a pre-authorization request","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/insurance/pre-authorizations/{pa_id}","href":"/api-reference/hmo-insurance/get-a-pre-authorization-request"},{"title":"Decide a pre-authorization request","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/insurance/pre-authorizations/{pa_id}/decision","href":"/api-reference/hmo-insurance/decide-a-pre-authorization-request"},{"title":"List payment advices","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/insurance/payment-advices","href":"/api-reference/hmo-insurance/list-payment-advices"},{"title":"Send a payment advice","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/insurance/payment-advices","href":"/api-reference/hmo-insurance/send-a-payment-advice"}]},{"group":"Inventory","pages":[{"title":"List stock locations","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/inventory/locations","href":"/api-reference/inventory/list-stock-locations"},{"title":"List catalogue items","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/inventory/items","href":"/api-reference/inventory/list-catalogue-items"},{"title":"Create a catalogue item","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/inventory/items","href":"/api-reference/inventory/create-a-catalogue-item"},{"title":"Get a catalogue item","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/inventory/items/{item_id}","href":"/api-reference/inventory/get-a-catalogue-item"},{"title":"Update a catalogue item","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml patch /v1/clinics/{clinic_id}/inventory/items/{item_id}","href":"/api-reference/inventory/update-a-catalogue-item"},{"title":"Delete an unused item","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml delete /v1/clinics/{clinic_id}/inventory/items/{item_id}","href":"/api-reference/inventory/delete-an-unused-item"},{"title":"Check item availability","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/inventory/availability","href":"/api-reference/inventory/check-item-availability"},{"title":"List stock quantities","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/inventory/stock","href":"/api-reference/inventory/list-stock-quantities"},{"title":"Upload an external stock batch","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/inventory/external-stock/batches","href":"/api-reference/inventory/upload-an-external-stock-batch"},{"title":"Get an external stock batch","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/inventory/external-stock/batches/{batch_id}","href":"/api-reference/inventory/get-an-external-stock-batch"},{"title":"Archive a catalogue item","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/inventory/items/{item_id}/archive","href":"/api-reference/inventory/archive-a-catalogue-item"},{"title":"Restore a catalogue item","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/inventory/items/{item_id}/restore","href":"/api-reference/inventory/restore-a-catalogue-item"},{"title":"Write off a lot","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/inventory/lots/{lot_id}/write-off","href":"/api-reference/inventory/write-off-a-lot"},{"title":"Receive stock","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/inventory/receive","href":"/api-reference/inventory/receive-stock"},{"title":"Adjust stock","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/inventory/adjust","href":"/api-reference/inventory/adjust-stock"},{"title":"Transfer stock","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/inventory/transfer","href":"/api-reference/inventory/transfer-stock"},{"title":"List your medicine codes","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/inventory/codes","href":"/api-reference/inventory/list-your-medicine-codes"},{"title":"Upload medicine codes","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/inventory/codes","href":"/api-reference/inventory/upload-medicine-codes"},{"title":"Get a medicine code","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/inventory/codes/{code_entry_id}","href":"/api-reference/inventory/get-a-medicine-code"},{"title":"Delete a medicine code","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml delete /v1/clinics/{clinic_id}/inventory/codes/{code_entry_id}","href":"/api-reference/inventory/delete-a-medicine-code"}]},{"group":"Dispensing","pages":[{"title":"List dispensing history","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/dispensing/history","href":"/api-reference/dispensing/list-dispensing-history"},{"title":"List dispensing flags","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/dispensing/flags","href":"/api-reference/dispensing/list-dispensing-flags"}]},{"group":"Drug requests","pages":[{"title":"List drug requests","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/drug_requests","href":"/api-reference/drug-requests/list-drug-requests"},{"title":"Send a drug request","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/drug_requests","href":"/api-reference/drug-requests/send-a-drug-request"},{"title":"Get a drug request","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/drug_requests/{request_id}","href":"/api-reference/drug-requests/get-a-drug-request"},{"title":"Cancel a drug request","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/drug_requests/{request_id}/cancel","href":"/api-reference/drug-requests/cancel-a-drug-request"},{"title":"Answer a substitution","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/drug_requests/{request_id}/confirm_substitution","href":"/api-reference/drug-requests/answer-a-substitution"}]},{"group":"Pharmacy listings","pages":[{"title":"List reachable pharmacies","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/listings/pharmacies","href":"/api-reference/listing/list-reachable-pharmacies"},{"title":"Search listed pharmacies","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/listings/search","href":"/api-reference/listing/search-listed-pharmacies"},{"title":"Send search feedback","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/listings/feedback","href":"/api-reference/listing/send-search-feedback"},{"title":"List a pharmacy's listed items","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/listing/items","href":"/api-reference/listing/list-a-pharmacys-listed-items"},{"title":"Get a pharmacy's listing profile","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/listing/profile","href":"/api-reference/listing/get-a-pharmacys-listing-profile"}]},{"group":"CRM","pages":[{"title":"List pipelines","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/crm/pipelines","href":"/api-reference/crm/list-pipelines"},{"title":"List contacts","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/crm/contacts","href":"/api-reference/crm/list-contacts"},{"title":"Create a contact","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/crm/contacts","href":"/api-reference/crm/create-a-contact"},{"title":"Search contacts","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/crm/contacts/search","href":"/api-reference/crm/search-contacts"},{"title":"Get a contact","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/crm/contacts/{contact_id}","href":"/api-reference/crm/get-a-contact"},{"title":"Update a contact","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml patch /v1/clinics/{clinic_id}/crm/contacts/{contact_id}","href":"/api-reference/crm/update-a-contact"},{"title":"List a contact's activities","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/crm/contacts/{contact_id}/activities","href":"/api-reference/crm/list-a-contacts-activities"},{"title":"Log an activity","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml post /v1/clinics/{clinic_id}/crm/contacts/{contact_id}/activities","href":"/api-reference/crm/log-an-activity"}]},{"group":"Events","pages":[{"title":"List events","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/clinics/{clinic_id}/events","href":"/api-reference/events/list-events"}]},{"group":"FHIR","pages":[{"title":"Get the FHIR capability statement","deprecated":null,"version":null,"openapi":"/openapi/ehr-api.v1.yaml get /v1/metadata","href":"/api-reference/fhir/get-the-fhir-capability-statement"}]}]}]},"basePath":"","title":"Get a referral - ClinikEHR API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}