RelatedPerson

Overview

RelatedPerson resource represents individuals who are related to a patient such as family members, caregivers, guardians, etc.

Use Cases

Family Health History - Maintain family members' demographics, conditions, procedures.
Caregiver Management - Identify and coordinate with designated caregivers.
Patient Outreach - Engage family members/caregivers for care plan adherence.
Pediatrics - Manage legal guardians and their relationship to pediatric patients.
Delegated Access - Allow caregiver proxy access to patient data where permitted.
Social Determinants - Capture and analyze social support network availability.
Care Coordination - Facilitate transitions of care with caregivers and family members.
Patient Matching - Use relatives' demographics to accurately match patients.
Patient Referrals - Allow patients to refer family/friends to providers and facilities.
Clinical Research - Manage related person data and consents for research recruitment.

EHR Data Model

EHR	Supported?	Mapped Source Object
Athena	✅
Elation	✅
Epic	✅

Object Definition

{
  "resourceType": "RelatedPerson",
  "id": "benedicte",
  "text": {
    "status": "generated",
    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n      <table>\n        <tbody>\n          <tr>\n            <td>Name</td>\n            <td>Bénédicte du Marché</td>\n          </tr>\n          <tr>\n            <td>Address</td>\n            <td>43, Place du Marché Sainte Catherine, 75004 Paris, France</td>\n          </tr>\n          <tr>\n            <td>Contacts</td>\n            <td>Phone: +33 (237) 998327</td>\n          </tr>\n        </tbody>\n      </table>\n    </div>"
  },
  "identifier": [
    {
      "use": "usual",
      "type": {
        "text": "INSEE"
      },
      "system": "urn:oid:1.2.250.1.61",
      "value": "272117510400399"
    }
  ],
  "active": true,
  "patient": {
    "reference": "Patient/example"
  },
  "relationship": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0131",
          "code": "N"
        },
        {
          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
          "code": "WIFE"
        }
      ]
    }
  ],
  "name": [
    {
      "family": "du Marché",
      "_family": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/humanname-own-prefix",
            "valueString": "VV"
          }
        ]
      },
      "given": [
        "Bénédicte"
      ]
    }
  ],
  "telecom": [
    {
      "system": "phone",
      "value": "+33 (237) 998327"
    }
  ],
  "gender": "female",
  "address": [
    {
      "line": [
        "43, Place du Marché Sainte Catherine"
      ],
      "city": "Paris",
      "postalCode": "75004",
      "country": "FRA"
    }
  ],
  "photo": [
    {
      "contentType": "image/jpeg",
      "url": "Binary/f016"
    }
  ],
  "meta": {
    "tag": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/v3-ActReason",
        "code": "HTEST",
        "display": "test health data"
      }
    ]
  }
}

Data Fields

Data Field	Type	Description
resourceType	RelatedPerson	This is a RelatedPerson resource
id	id	The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.
meta	Meta	The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.
implicitRules	uri	A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.
language	code	The base language in which the resource is written.
text	Narrative	A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety.
contained	BackboneElement	These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.
extension	Extension	May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
modifierExtension	Extension	May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
identifier	Identifier	Identifier for a person within a particular scope.
active	boolean	Whether this related person record is in active use.
patient	Reference	The patient this person is related to.
relationship	CodeableConcept	The nature of the relationship between a patient and the related person.
name	HumanName	A name associated with the person.
telecom	ContactPoint	A contact detail for the person, e.g. a telephone number or an email address.
gender	code	Administrative Gender - the gender that the person is considered to have for administration and record keeping purposes.
birthDate	date	The date on which the related person was born.
address	Address	Address where the related person can be contacted or visited.
photo	Attachment	Image of the person.
period	Period	The period of time during which this relationship is or was active. If there are no dates defined, then the interval is unknown.
communication	BackboneElement	A language which may be used to communicate with about the patient's health.
communication.id	string	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
communication.extension	Extension	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
communication.modifierExtension	Extension	May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
communication.language	CodeableConcept	The 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-EN" for England English.
communication.preferred	boolean	Indicates whether or not the patient prefers this language (over other languages he masters up a certain level).

Extensions

Name	URL

RelatedPerson

Overview

Use Cases

EHR Data Model

Object Definition

Data Fields

Extensions

Operations & APIs

RelatedPerson-GET

RelatedPerson-POST

RelatedPerson ID-GET

RelatedPerson ID-PUT

RelatedPerson ID-DELETE