Create a new referral link

Authentication

Authorizationstring
API Key authentication via header

Request

This endpoint expects an object.
referrerInstitutionIdstringRequired
HCI code of the institution authoring this referral.
referrerInstitutionIdType"hci"Required
The type of institution ID
referrerInstitutionNamestringRequired
Name of the institution authoring this referral.
referrerIdstringRequired
Id of the doctor authoring this referral.
requesterIdentifierstringRequired
Identifier for the individual requesting the link. The individual may or may not be the referrer. Preferred to be an email.
referrerIdTypeenumRequired
Type of ID specified in referrerId.
Allowed values:
referrerNamestringRequired
Name of the doctor authoring this referral.
referrerEmailstringOptional
Email of the doctor authoring this referral.
referrerContactNumberstringOptionalformat: "^[3689][0-9]{7}$"
Contact number of the doctor authoring this referral.
patientUinstringOptional
Patient UIN, e.g. NRIC or FIN
patientNamestringOptional
Patient name
patientPhoneNumberstringOptionalformat: "^[3689][0-9]{7}$"

Patient phone number - only Singaporean accepted for now

patientDobstringOptional
Patient date of birth
patientGenderenumOptional
Patient gender
Allowed values:
addressobjectOptional
residentialStatusenumOptional
Patient residential status
Allowed values:
isPatientHsgEnrolledbooleanOptional

Patient Healthier SG (HSG) enrolment status

clinicLicenseNumberstringOptional
Clinic license number
clinicTypeenumOptional
Clinic type
Allowed values:
clinicalInfostringOptional
Any clinical information that is relevant to the referral, e.g. medical history, drug allergies, treatment provided, etc.

Response

referralIdstring
The ID of the referral
urlstring
The URL of the link
type"upsert"
type of referral link

Errors

400
Links Create Upsert Link Request Bad Request Error
401
Links Create Upsert Link Request Unauthorized Error