Skip to main content

Patient

Demographics and other administrative information about an individual or animal receiving care or other health-related services.

These interaction paths describe standard FHIR R4 patterns. Availability can depend on the API capabilities enabled for your Ovok project.

InteractionMethodPath
ReadGET/fhir/R4/Patient/[id]
VreadGET/fhir/R4/Patient/[id]/_history/[vid]
UpdatePUT/fhir/R4/Patient/[id]
PatchPATCH/fhir/R4/Patient/[id]
DeleteDELETE/fhir/R4/Patient/[id]
CreatePOST/fhir/R4/Patient
SearchGET/fhir/R4/Patient
HistoryGET/fhir/R4/Patient/[id]/_history

Top-level elements​

ElementTypeCardinalityDescription
idstring0..1Logical id of this artifact
metaMeta0..1Metadata about the resource
implicitRulesuri0..1A set of rules under which this content was created
languagecode0..1Language of the resource content
textNarrative0..1Text summary of the resource, for human interpretation
containedResource0..*Contained, inline Resources
extensionExtension0..*Additional content defined by implementations
modifierExtensionExtension0..*Extensions that cannot be ignored
identifierIdentifier0..*An identifier for this patient
activeboolean0..1Whether this patient's record is in active use
nameHumanName0..*A name associated with the patient
telecomContactPoint0..*A contact detail for the individual
gendercode0..1male | female | other | unknown
birthDatedate0..1The date of birth for the individual
deceased[x]boolean, dateTime0..1Indicates if the individual is deceased or not
addressAddress0..*An address for the individual
maritalStatusCodeableConcept0..1Marital (civil) status of a patient
multipleBirth[x]boolean, integer0..1Whether patient is part of a multiple birth
photoAttachment0..*Image of the patient
contactBackboneElement0..*A contact party (e.g. guardian, partner, friend) for the patient
communicationBackboneElement0..*A language which may be used to communicate with the patient about his or her health
generalPractitionerReference0..*Patient's nominated primary care provider
managingOrganizationReference0..1Organization that is the custodian of the patient record
linkBackboneElement0..*Link to another patient resource that concerns the same actual person

Resource-specific search parameters​

ParameterTypeDescription
activetokenWhether the patient record is active
addressstringMultiple Resources: Patient: A server defined search that may match any of the string fields in the Address, including line, city, district, state, country, postalCode, and/or text ; Person: A server defined search that may match any of the string fields in the Address, including line, city, district, state, country, postalCode, and/or text ; Practitioner: A server defined search that may match any of the string fields in the Address, including line, city, district, state, country, postalCode, and/or text ; RelatedPerson: A server defined search that may match any of the string fields in the Address, including line, city, district, state, country, postalCode, and/or text
address-citystringMultiple Resources: Patient: A city specified in an address ; Person: A city specified in an address ; Practitioner: A city specified in an address ; RelatedPerson: A city specified in an address
address-countrystringMultiple Resources: Patient: A country specified in an address ; Person: A country specified in an address ; Practitioner: A country specified in an address ; RelatedPerson: A country specified in an address
address-postalcodestringMultiple Resources: Patient: A postalCode specified in an address ; Person: A postal code specified in an address ; Practitioner: A postalCode specified in an address ; RelatedPerson: A postal code specified in an address
address-statestringMultiple Resources: Patient: A state specified in an address ; Person: A state specified in an address ; Practitioner: A state specified in an address ; RelatedPerson: A state specified in an address
address-usetokenMultiple Resources: Patient: A use code specified in an address ; Person: A use code specified in an address ; Practitioner: A use code specified in an address ; RelatedPerson: A use code specified in an address
agenumberSearches for patients based on age as calculated based on current date and date of birth. Deceased patients are excluded from the search.
birthdatedateMultiple Resources: Patient: The patient's date of birth ; Person: The person's date of birth ; RelatedPerson: The Related Person's date of birth
birthOrderBooleantokenSearch based on whether a patient was part of a multiple birth or not.
death-datedateThe date of death has been provided and satisfies this search value
deceasedtokenThis patient has been marked as deceased, or as a death date entered
emailtokenMultiple Resources: Patient: A value in an email contact ; Person: A value in an email contact ; Practitioner: A value in an email contact ; PractitionerRole: A value in an email contact ; RelatedPerson: A value in an email contact
familystringMultiple Resources: Patient: A portion of the family name of the patient ; Practitioner: A portion of the family name
gendertokenMultiple Resources: Patient: Gender of the patient ; Person: The gender of the person ; Practitioner: Gender of the practitioner ; RelatedPerson: Gender of the related person
general-practitionerreferencePatient's nominated general practitioner, not the organization that manages the record
givenstringMultiple Resources: Patient: A portion of the given name of the patient ; Practitioner: A portion of the given name
identifiertokenA patient identifier
languagetokenLanguage code (irrespective of use value)
linkreferenceAll patients linked to the given patient
mothersMaidenNamestringSearch based on patient's mother's maiden name
namestringA server defined search that may match any of the string fields in the HumanName, including family, give, prefix, suffix, suffix, and/or text
organizationreferenceThe organization that is the custodian of the patient record
part-agreereferenceSearch by url for a participation agreement, which is stored in a DocumentReference
phonetokenMultiple Resources: Patient: A value in a phone contact ; Person: A value in a phone contact ; Practitioner: A value in a phone contact ; PractitionerRole: A value in a phone contact ; RelatedPerson: A value in a phone contact
phoneticstringMultiple Resources: Patient: A portion of either family or given name using some kind of phonetic matching algorithm ; Person: A portion of name using some kind of phonetic matching algorithm ; Practitioner: A portion of either family or given name using some kind of phonetic matching algorithm ; RelatedPerson: A portion of name using some kind of phonetic matching algorithm
telecomtokenMultiple Resources: Patient: The value in any kind of telecom details of the patient ; Person: The value in any kind of contact ; Practitioner: The value in any kind of contact ; PractitionerRole: The value in any kind of contact ; RelatedPerson: The value in any kind of contact

Reference​

Official FHIR R4 spec: Patient.
Maturity: Trial Use 5 (FMM 5).