Skip to main content

RelatedPerson

Information about a person that is involved in the care for a patient, but who is not the target of healthcare, nor has a formal responsibility in the care process.

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

InteractionMethodPath
ReadGET/fhir/R4/RelatedPerson/[id]
VreadGET/fhir/R4/RelatedPerson/[id]/_history/[vid]
UpdatePUT/fhir/R4/RelatedPerson/[id]
PatchPATCH/fhir/R4/RelatedPerson/[id]
DeleteDELETE/fhir/R4/RelatedPerson/[id]
CreatePOST/fhir/R4/RelatedPerson
SearchGET/fhir/R4/RelatedPerson
HistoryGET/fhir/R4/RelatedPerson/[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..*A human identifier for this person
activeboolean0..1Whether this related person's record is in active use
patientReference1..1The patient this person is related to
relationshipCodeableConcept0..*The nature of the relationship
nameHumanName0..*A name associated with the person
telecomContactPoint0..*A contact detail for the person
gendercode0..1male | female | other | unknown
birthDatedate0..1The date on which the related person was born
addressAddress0..*Address where the related person can be contacted or visited
photoAttachment0..*Image of the person
periodPeriod0..1Period of time that this relationship is considered valid
communicationBackboneElement0..*A language which may be used to communicate with about the patient's health

Resource-specific search parameters​

ParameterTypeDescription
activetokenIndicates if the related person 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
birthdatedateMultiple Resources: Patient: The patient's date of birth ; Person: The person's date of birth ; RelatedPerson: The Related Person's date of birth
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
gendertokenMultiple Resources: Patient: Gender of the patient ; Person: The gender of the person ; Practitioner: Gender of the practitioner ; RelatedPerson: Gender of the related person
identifiertokenAn Identifier of the RelatedPerson
namestringA server defined search that may match any of the string fields in the HumanName, including family, give, prefix, suffix, suffix, and/or text
patientreferenceThe patient this related person is related to
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
relationshiptokenThe relationship between the patient and the relatedperson
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: RelatedPerson.
Maturity: Trial Use 2 (FMM 2).