Skip to main content
GET
Get a referral

Authorizations

Authorization
string
header
required

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.