API ReferencePre EncounterPatientsV1

Create With Mrn

Beta

Adds a patient and hydrates their MRN with a pre-existing MRN. Once this patient is created their MRN will not be editable. BadRequestError is returned when the MRN is greater than 20 characters. VersionConflictError is returned when the patient’s external ID is already in use.

Headers

AuthorizationstringRequired

OAuth authentication of the form <token>.

Query parameters

skip_duplicate_checkbooleanOptional

Request

This endpoint expects an object.
biological_sexenumRequired

The biological sex of the patient. This corresponds to the HL7 AdministrativeGender https://www.hl7.org/fhir/valueset-administrative-gender.html

Allowed values:
birth_datedateRequired
contactslist of objectsRequired
Contacts for the patient.
filing_orderobjectRequired
The patient's active coverages, in order of primary, secondary, etc.
general_practitionerslist of objectsRequired
mrnstringRequired
The medical record number for the patient.
nameobjectRequired
other_addresseslist of objectsRequired
Other addresses for the patient.
other_nameslist of objectsRequired
Other names for the patient.
other_telecomslist of objectsRequired
Other phone numbers for the patient.
primary_addressobjectRequired
The primary address for the patient.
primary_telecomobjectRequired
The primary phone number for the patient.
authorizationslist of objectsOptional
deceaseddatetimeOptional
Time of death for the patient. Leave unset if the patient is not deceased.
disability_statusenumOptional
Allowed values:
do_not_invoice_reasonenumOptional
If this value is defined, the customer will not be invoiced.
Allowed values:
electronic_communication_opt_inbooleanOptional
emailstringOptional
ethnicityenumOptional
Allowed values:
external_provenanceobjectOptional
Information about the upstream system that owns this patient data. Leave unset if Candid owns patient data.
genderenumOptional
guarantorobjectOptional
languagestringOptional
marital_statusenumOptional
multiple_birthintegerOptional
The number of siblings the patient was born with. Leave unset if the patient was not part of a multiple birth.
non_insurance_payer_associationslist of objectsOptional
note_idslist of stringsOptional
other_identifierslist of objectsOptional
Other identifiers for the patient.
photostringOptional
primary_service_facility_idstringOptional
pronounslist of stringsOptional
The pronouns of the patient.
raceenumOptional
referralslist of objectsOptional
self_paybooleanOptional
sexual_orientationenumOptional
The sexual orientation of the patient.
social_security_numberstringOptional
tag_idslist of stringsOptional
non_insurance_payerslist of stringsOptionalDeprecated

Response

This endpoint returns an object.
biological_sexenum

The biological sex of the patient. This corresponds to the HL7 AdministrativeGender https://www.hl7.org/fhir/valueset-administrative-gender.html

Allowed values:
birth_datedate
contactslist of objects
Contacts for the patient.
deactivatedboolean
True if the object is deactivated. Deactivated objects are not returned in search results but are returned in all other endpoints including scan.
filing_orderobject
The patient's active coverages, in order of primary, secondary, etc.
general_practitionerslist of objects
idstring
The unique UUID identifier for a Patient. Patient ID is used in machine contexts.
mrnstring

The medical record number for the patient. Human-friendly Candid generated MRNs are of the form “YYMMDDXXXX”, where “YYYYMMDD” is the date of patient creation and “XXXX” is a zero-padded incrementing integer.

nameobject
organization_idstring
The organization that owns this object.
other_addresseslist of objects
Other addresses for the patient.
other_nameslist of objects
Other names for the patient.
other_telecomslist of objects
Other phone numbers for the patient.
primary_addressobject
The primary address for the patient.
primary_telecomobject
The primary phone number for the patient.
updated_atdatetime
updating_user_idstring
The user ID of the user who last updated the object.
versioninteger
The version of the object. Any update to any property of an object object will create a new version.
authorizationslist of objects or null
deceaseddatetime or null
Time of death for the patient. Leave unset if the patient is not deceased.
disability_statusenum or null
Allowed values:
do_not_invoice_reasonenum or null
If this value is defined, the customer will not be invoiced.
Allowed values:
electronic_communication_opt_inboolean or null
emailstring or null
ethnicityenum or null
Allowed values:
external_provenanceobject or null
Information about the upstream system that owns this patient data. Leave unset if Candid owns patient data.
genderenum or null
guarantorobject or null
languagestring or null
marital_statusenum or null
multiple_birthinteger or null
The number of siblings the patient was born with. Leave unset if the patient was not part of a multiple birth.
non_insurance_payer_associationslist of objects or null
note_idslist of strings or null
other_identifierslist of objects or null
Other identifiers for the patient.
photostring or null
primary_service_facility_idstring or null
pronounslist of strings or null
The pronouns of the patient.
raceenum or null
referralslist of objects or null
self_payboolean or null
sexual_orientationenum or null
The sexual orientation of the patient.
social_security_numberstring or null
tag_idslist of strings or null
non_insurance_payerslist of strings or nullDeprecated

Errors