Release 5

This page is part of the FHIR Specification (v5.0.0: R5 - STU). This is the current published version. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

8.2 Resource RelatedPerson - Content

Patient Administration icon Work GroupMaturity Level: 5 Trial UseSecurity Category: Patient Compartments: Patient, RelatedPerson

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

RelatedPersons typically have a personal relationship or non-healthcare-specific professional relationship to the patient. A RelatedPerson resource is primarily used for attribution of information, since RelatedPersons are often a source of information about the patient. For keeping information about people for contact purposes for a patient, use a Patient's Contact element. Some individuals may serve as both a Patient's Contact and a Related Person.

Example RelatedPersons are:

  • A patient's wife or husband
  • A patient's relatives or friends
  • A neighbor bringing a patient to the hospital
  • The owner or trainer of a horse
  • A patient's attorney or guardian
  • A Guide Dog

The primary distinction between a Practitioner and a RelatedPerson is based on whether:

  • The person/animal operates on behalf of the care delivery organization over multiple patients (Practitioner) or,
  • Where the person/animal is not associated with the organization, and instead is allocated tasks specifically for the RelatedPerson's Patient (RelatedPerson).

A standard extension animalSpecies can be used to indicate the species of a service animal.

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. RelatedPerson TUDomainResourceA person that is related to a patient, but who is not a direct target of care

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..*IdentifierA human identifier for this person

... active ?!Σ0..1booleanWhether this related person's record is in active use
... patient Σ1..1Reference(Patient)The patient this person is related to
... name Σ0..*HumanNameA name associated with the person

... telecom Σ0..*ContactPointA contact detail for the person

... gender Σ0..1codemale | female | other | unknown
Binding: AdministrativeGender (Required)
... birthDate Σ0..1dateThe date on which the related person was born
... address Σ0..*AddressAddress where the related person can be contacted or visited

... photo 0..*AttachmentImage of the person

... period 0..1PeriodPeriod of time that this relationship is considered valid
... communication 0..*BackboneElementA language which may be used to communicate with the related person about the patient's health

.... language 1..1CodeableConceptThe language which can be used to communicate with the related person about the patient's health
Binding: All Languages (Required)
Additional BindingsPurpose
Common LanguagesStarter Set

.... preferred 0..1booleanLanguage preference indicator

doco Documentation for this format icon

See the Extensions for this resource

UML Diagram (Legend)

RelatedPerson (DomainResource)Identifier for a person within a particular scopeidentifier : Identifier [0..*]Whether this related person record is in active use (this element modifies the meaning of other elements)active : boolean [0..1]The patient this person is related topatient : Reference [1..1] « Patient »The nature of the relationship between the related person and the patientrelationship : CodeableConcept [0..*] « null (Strength=Preferred)PatientRelationshipType? »A name associated with the personname : HumanName [0..*]A contact detail for the person, e.g. a telephone number or an email addresstelecom : ContactPoint [0..*]Administrative Gender - the gender that the person is considered to have for administration and record keeping purposesgender : code [0..1] « null (Strength=Required)AdministrativeGender! »The date on which the related person was bornbirthDate : date [0..1]Address where the related person can be contacted or visitedaddress : Address [0..*]Image of the personphoto : Attachment [0..*]The period of time during which this relationship is or was active. If there are no dates defined, then the interval is unknownperiod : Period [0..1]CommunicationThe ISO-639-1 alpha 2 code in lower case for the language, optionally followed by a hyphen and the ISO-3166-1 alpha 2 code for the region in upper case; e.g. "en" for English, or "en-US" for American English versus "en-AU" for Australian Englishlanguage : CodeableConcept [1..1] « null (Strength=Required)AllLanguages! »Indicates whether or not the related person prefers this language (over other languages he or she masters up a certain level)preferred : boolean [0..1]A language which may be used to communicate with the related person about the patient's healthcommunication[0..*]

XML Template

<RelatedPerson xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier A human identifier for this person --></identifier>
 <active value="[boolean]"/><!-- 0..1 Whether this related person's record is in active use -->
 <patient><!-- 1..1 Reference(Patient) The patient this person is related to --></patient>
 <relationship><!-- 0..* CodeableConcept The relationship of the related person to the patient --></relationship>
 <name><!-- 0..* HumanName A name associated with the person --></name>
 <telecom><!-- 0..* ContactPoint A contact detail for the person --></telecom>
 <gender value="[code]"/><!-- 0..1 male | female | other | unknown -->
 <birthDate value="[date]"/><!-- 0..1 The date on which the related person was born -->
 <address><!-- 0..* Address Address where the related person can be contacted or visited --></address>
 <photo><!-- 0..* Attachment Image of the person --></photo>
 <period><!-- 0..1 Period Period of time that this relationship is considered valid --></period>
 <communication>  <!-- 0..* A language which may be used to communicate with the related person about the patient's health -->
  <language><!-- 1..1 CodeableConcept The language which can be used to communicate with the related person about the patient's health --></language>
  <preferred value="[boolean]"/><!-- 0..1 Language preference indicator -->
 </communication>
</RelatedPerson>

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:RelatedPerson;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* A human identifier for this person
  fhir:active [ boolean ] ; # 0..1 Whether this related person's record is in active use
  fhir:patient [ Reference(Patient) ] ; # 1..1 The patient this person is related to
  fhir:relationship  ( [ CodeableConcept ] ... ) ; # 0..* The relationship of the related person to the patient
  fhir:name  ( [ HumanName ] ... ) ; # 0..* A name associated with the person
  fhir:telecom  ( [ ContactPoint ] ... ) ; # 0..* A contact detail for the person
  fhir:gender [ code ] ; # 0..1 male | female | other | unknown
  fhir:birthDate [ date ] ; # 0..1 The date on which the related person was born
  fhir:address  ( [ Address ] ... ) ; # 0..* Address where the related person can be contacted or visited
  fhir:photo  ( [ Attachment ] ... ) ; # 0..* Image of the person
  fhir:period [ Period ] ; # 0..1 Period of time that this relationship is considered valid
  fhir:communication ( [ # 0..* A language which may be used to communicate with the related person about the patient's health
    fhir:language [ CodeableConcept ] ; # 1..1 The language which can be used to communicate with the related person about the patient's health
    fhir:preferred [ boolean ] ; # 0..1 Language preference indicator
  ] ... ) ;
]

Changes from both R4 and R4B

RelatedPerson
RelatedPerson.communication.language

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

See R4 <--> R5 Conversion Maps (status = See Conversions Summary.)

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. RelatedPerson TUDomainResourceA person that is related to a patient, but who is not a direct target of care

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..*IdentifierA human identifier for this person

... active ?!Σ0..1booleanWhether this related person's record is in active use
... patient Σ1..1Reference(Patient)The patient this person is related to
... name Σ0..*HumanNameA name associated with the person

... telecom Σ0..*ContactPointA contact detail for the person

... gender Σ0..1codemale | female | other | unknown
Binding: AdministrativeGender (Required)
... birthDate Σ0..1dateThe date on which the related person was born
... address Σ0..*AddressAddress where the related person can be contacted or visited

... photo 0..*AttachmentImage of the person

... period 0..1PeriodPeriod of time that this relationship is considered valid
... communication 0..*BackboneElementA language which may be used to communicate with the related person about the patient's health

.... language 1..1CodeableConceptThe language which can be used to communicate with the related person about the patient's health
Binding: All Languages (Required)
Additional BindingsPurpose
Common LanguagesStarter Set

.... preferred 0..1booleanLanguage preference indicator

doco Documentation for this format icon

See the Extensions for this resource

UML Diagram (Legend)

RelatedPerson (DomainResource)Identifier for a person within a particular scopeidentifier : Identifier [0..*]Whether this related person record is in active use (this element modifies the meaning of other elements)active : boolean [0..1]The patient this person is related topatient : Reference [1..1] « Patient »The nature of the relationship between the related person and the patientrelationship : CodeableConcept [0..*] « null (Strength=Preferred)PatientRelationshipType? »A name associated with the personname : HumanName [0..*]A contact detail for the person, e.g. a telephone number or an email addresstelecom : ContactPoint [0..*]Administrative Gender - the gender that the person is considered to have for administration and record keeping purposesgender : code [0..1] « null (Strength=Required)AdministrativeGender! »The date on which the related person was bornbirthDate : date [0..1]Address where the related person can be contacted or visitedaddress : Address [0..*]Image of the personphoto : Attachment [0..*]The period of time during which this relationship is or was active. If there are no dates defined, then the interval is unknownperiod : Period [0..1]CommunicationThe ISO-639-1 alpha 2 code in lower case for the language, optionally followed by a hyphen and the ISO-3166-1 alpha 2 code for the region in upper case; e.g. "en" for English, or "en-US" for American English versus "en-AU" for Australian Englishlanguage : CodeableConcept [1..1] « null (Strength=Required)AllLanguages! »Indicates whether or not the related person prefers this language (over other languages he or she masters up a certain level)preferred : boolean [0..1]A language which may be used to communicate with the related person about the patient's healthcommunication[0..*]

XML Template

<RelatedPerson xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier A human identifier for this person --></identifier>
 <active value="[boolean]"/><!-- 0..1 Whether this related person's record is in active use -->
 <patient><!-- 1..1 Reference(Patient) The patient this person is related to --></patient>
 <relationship><!-- 0..* CodeableConcept The relationship of the related person to the patient --></relationship>
 <name><!-- 0..* HumanName A name associated with the person --></name>
 <telecom><!-- 0..* ContactPoint A contact detail for the person --></telecom>
 <gender value="[code]"/><!-- 0..1 male | female | other | unknown -->
 <birthDate value="[date]"/><!-- 0..1 The date on which the related person was born -->
 <address><!-- 0..* Address Address where the related person can be contacted or visited --></address>
 <photo><!-- 0..* Attachment Image of the person --></photo>
 <period><!-- 0..1 Period Period of time that this relationship is considered valid --></period>
 <communication>  <!-- 0..* A language which may be used to communicate with the related person about the patient's health -->
  <language><!-- 1..1 CodeableConcept The language which can be used to communicate with the related person about the patient's health --></language>
  <preferred value="[boolean]"/><!-- 0..1 Language preference indicator -->
 </communication>
</RelatedPerson>

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:RelatedPerson;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* A human identifier for this person
  fhir:active [ boolean ] ; # 0..1 Whether this related person's record is in active use
  fhir:patient [ Reference(Patient) ] ; # 1..1 The patient this person is related to
  fhir:relationship  ( [ CodeableConcept ] ... ) ; # 0..* The relationship of the related person to the patient
  fhir:name  ( [ HumanName ] ... ) ; # 0..* A name associated with the person
  fhir:telecom  ( [ ContactPoint ] ... ) ; # 0..* A contact detail for the person
  fhir:gender [ code ] ; # 0..1 male | female | other | unknown
  fhir:birthDate [ date ] ; # 0..1 The date on which the related person was born
  fhir:address  ( [ Address ] ... ) ; # 0..* Address where the related person can be contacted or visited
  fhir:photo  ( [ Attachment ] ... ) ; # 0..* Image of the person
  fhir:period [ Period ] ; # 0..1 Period of time that this relationship is considered valid
  fhir:communication ( [ # 0..* A language which may be used to communicate with the related person about the patient's health
    fhir:language [ CodeableConcept ] ; # 1..1 The language which can be used to communicate with the related person about the patient's health
    fhir:preferred [ boolean ] ; # 0..1 Language preference indicator
  ] ... ) ;
]

Changes from both R4 and R4B

RelatedPerson
RelatedPerson.communication.language

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

See R4 <--> R5 Conversion Maps (status = See Conversions Summary.)

 

Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis

PathValueSetTypeDocumentation
RelatedPerson.relationship PatientRelationshipType Preferred

A set of codes that can be used to indicate the relationship between a Patient and a Related Person.

RelatedPerson.gender AdministrativeGender Required

The gender of a person used for administrative purposes.

RelatedPerson.communication.language AllLanguages (a valid code from Tags for the Identification of Languages icon)Required

This value set includes all possible codes from BCP-47 (see http://tools.ietf.org/html/bcp47)

  Common Languages starter

Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionExpressionIn Common
activetokenIndicates if the related person record is activeRelatedPerson.active
addressstringA server defined search that may match any of the string fields in the Address, including line, city, district, state, country, postalCode, and/or textRelatedPerson.address4 Resources
address-citystringA city specified in an addressRelatedPerson.address.city4 Resources
address-countrystringA country specified in an addressRelatedPerson.address.country4 Resources
address-postalcodestringA postal code specified in an addressRelatedPerson.address.postalCode4 Resources
address-statestringA state specified in an addressRelatedPerson.address.state4 Resources
address-usetokenA use code specified in an addressRelatedPerson.address.use4 Resources
birthdatedateThe Related Person's date of birthRelatedPerson.birthDate3 Resources
emailtokenA value in an email contactRelatedPerson.telecom.where(system='email')5 Resources
familystringA portion of the family name of the related personRelatedPerson.name.family
gendertokenGender of the related personRelatedPerson.gender4 Resources
givenstringA portion of the given name of the related personRelatedPerson.name.given
identifiertokenAn Identifier of the RelatedPersonRelatedPerson.identifier65 Resources
namestringA server defined search that may match any of the string fields in the HumanName, including family, give, prefix, suffix, suffix, and/or textRelatedPerson.name
patientreferenceThe patient this related person is related toRelatedPerson.patient
(Patient)
66 Resources
phonetokenA value in a phone contactRelatedPerson.telecom.where(system='phone')5 Resources
phoneticstringA portion of name using some kind of phonetic matching algorithmRelatedPerson.name4 Resources
relationshiptokenThe relationship between the patient and the relatedpersonRelatedPerson.relationship
telecomtokenThe value in any kind of contactRelatedPerson.telecom5 Resources