2026 US Quality Core Implementation Guide
0.5.0 - release

2026 US Quality Core Implementation Guide - Downloaded Version 0.5.0 See the Directory of published versions

## Resource Profile: US Quality Core RelatedPerson

Official URL: http://fhir.org/guides/onc/us-quality-core/StructureDefinition/us-quality-core-relatedperson | Version: 0.5.0 | Highlight text changes?
Active as of 2026-06-05 | Computable Name: USQualityCoreRelatedPerson

Profile of RelatedPerson for decision support/quality metrics. Defines the core set of elements and extensions for quality rule and measure authors.

### USCDI+ Quality Element Support Expectations

Systems are expected to support this profile as part of implementing USCDI+ Quality V1 in FHIR and meeting the conformance requirements of this guide.

The following elements are specifically relevant to USCDI+ Quality V1 data classes and elements. Systems are expected to support these elements as applicable to their role in US Quality Core data exchange. See the Must Support section of this guide for more information. These elements are tagged as (USCDI+ Quality) in the formal profile views.

USCDI+ Quality Elements:

- relationship: (USCDI+ Quality) (USCDI) The nature of the relationship
- name: (USCDI+ Quality) (USCDI) A name associated with the person
- telecom: (USCDI+ Quality) (USCDI) A contact detail for the person
- address: (USCDI+ Quality) (USCDI) Address where the related person can be contacted or visited

Because this profile is derived from US Core, systems are also expected to support Must Support requirements and (USCDI) tagged elements inherited from US Core. The Formal Views section also provides the formal summary, definitions, terminology requirements, and mandatory element requirements.

Usages:

- Refer to this Profile: US Quality Core AdverseEvent, US Quality Core CareTeam, US Quality Core Claim, US Quality Core Communication... Show 15 more, US Quality Core CommunicationRequest, US Quality Core Coverage, US Quality Core Encounter, US Quality Core ImagingStudy, US Quality Core Medication Not Requested, US Quality Core MedicationRequest, US Quality Core MedicationStatement, US Quality Core NonPatient Observation, US Quality Core Observation Screening Assessment, US Quality Core Observation Cancelled, US Quality Core Procedure, US Quality Core QuestionnaireResponse, US Quality Core Service Not Requested, US Quality Core ServiceRequest and US Quality Core Simple Observation
- Examples for this Profile: RelatedPerson/example
- CapabilityStatements using this Profile: US Quality Core Client CapabilityStatement and US Quality Core Server CapabilityStatement

You can also check for usages in the FHIR IG Statistics

### Formal Views of Profile Content

Description Differentials, Snapshots, and other representations.

- Key Elements Table
- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
RelatedPerson | C | 0..* | USCoreRelatedPersonProfile(6.1.0) | A person that is related to a patient, but who is not a direct target of care Constraints: us-core-14
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
active | ?!S Σ | 1..1 | boolean | (USCDI) Whether this related person's record is in active use
patient | S Σ | 1..1 | Reference(US Quality Core Patient) | (USCDI) The patient this person is related to
relationship | S Σ C | 0..* | CodeableConcept | (USCDI+ Quality) (USCDI) The nature of the relationship Binding: PatientRelationshipType (preferred): The nature of the relationship between a patient and the related person.
name | S Σ C | 0..* | HumanName | (USCDI+ Quality) (USCDI) A name associated with the person
telecom | S Σ | 0..* | ContactPoint | (USCDI+ Quality) (USCDI) A contact detail for the person
address | S Σ | 0..* | Address | (USCDI+ Quality) (USCDI) Address where the related person can be contacted or visited
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
RelatedPerson.relationship | Base | preferred | Patient relationship type | 📦4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | RelatedPerson | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | RelatedPerson | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | RelatedPerson | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
us-core-14 | error | RelatedPerson | Either a name or a relationship SHALL be provided (or both) | `name.exists() or relationship.exists()`

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
RelatedPerson |  | 0..* | USCoreRelatedPersonProfile(6.1.0) | A person that is related to a patient, but who is not a direct target of care
active |  | 1..1 | boolean | (USCDI) Whether this related person's record is in active use
patient |  | 1..1 | Reference(US Quality Core Patient) | (USCDI) The patient this person is related to
relationship | C | 0..* | CodeableConcept | (USCDI+ Quality) (USCDI) The nature of the relationship
name | C | 0..* | HumanName | (USCDI+ Quality) (USCDI) A name associated with the person
telecom |  | 0..* | ContactPoint | (USCDI+ Quality) (USCDI) A contact detail for the person
address |  | 0..* | Address | (USCDI+ Quality) (USCDI) Address where the related person can be contacted or visited
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
RelatedPerson | C | 0..* | USCoreRelatedPersonProfile(6.1.0) | A person that is related to a patient, but who is not a direct target of care Constraints: us-core-14
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 0..* | Identifier | A human identifier for this person
active | ?!S Σ | 1..1 | boolean | (USCDI) Whether this related person's record is in active use
patient | S Σ | 1..1 | Reference(US Quality Core Patient) | (USCDI) The patient this person is related to
relationship | S Σ C | 0..* | CodeableConcept | (USCDI+ Quality) (USCDI) The nature of the relationship Binding: PatientRelationshipType (preferred): The nature of the relationship between a patient and the related person.
name | S Σ C | 0..* | HumanName | (USCDI+ Quality) (USCDI) A name associated with the person
telecom | S Σ | 0..* | ContactPoint | (USCDI+ Quality) (USCDI) A contact detail for the person
gender | Σ | 0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
birthDate | Σ | 0..1 | date | The date on which the related person was born
address | S Σ | 0..* | Address | (USCDI+ Quality) (USCDI) Address where the related person can be contacted or visited
photo |  | 0..* | Attachment | Image of the person
period |  | 0..1 | Period | Period of time that this relationship is considered valid
communication |  | 0..* | BackboneElement | A language which may be used to communicate with about the patient's health
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
language |  | 1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
preferred |  | 0..1 | boolean | Language preference indicator
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
RelatedPerson.language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.
RelatedPerson.relationship | Base | preferred | Patient relationship type | 📦4.0.1 | FHIR Std.
RelatedPerson.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std.
RelatedPerson.communication.​language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | RelatedPerson | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | RelatedPerson | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | RelatedPerson | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
us-core-14 | error | RelatedPerson | Either a name or a relationship SHALL be provided (or both) | `name.exists() or relationship.exists()`

Summary

Mandatory: 1 element

Structures

This structure refers to these other structures:

- US Quality Core Patient (http://fhir.org/guides/onc/us-quality-core/StructureDefinition/us-quality-core-patient)

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
RelatedPerson | C | 0..* | USCoreRelatedPersonProfile(6.1.0) | A person that is related to a patient, but who is not a direct target of care Constraints: us-core-14
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
active | ?!S Σ | 1..1 | boolean | (USCDI) Whether this related person's record is in active use
patient | S Σ | 1..1 | Reference(US Quality Core Patient) | (USCDI) The patient this person is related to
relationship | S Σ C | 0..* | CodeableConcept | (USCDI+ Quality) (USCDI) The nature of the relationship Binding: PatientRelationshipType (preferred): The nature of the relationship between a patient and the related person.
name | S Σ C | 0..* | HumanName | (USCDI+ Quality) (USCDI) A name associated with the person
telecom | S Σ | 0..* | ContactPoint | (USCDI+ Quality) (USCDI) A contact detail for the person
address | S Σ | 0..* | Address | (USCDI+ Quality) (USCDI) Address where the related person can be contacted or visited
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
RelatedPerson.relationship | Base | preferred | Patient relationship type | 📦4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | RelatedPerson | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | RelatedPerson | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | RelatedPerson | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
us-core-14 | error | RelatedPerson | Either a name or a relationship SHALL be provided (or both) | `name.exists() or relationship.exists()`

Differential View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
RelatedPerson |  | 0..* | USCoreRelatedPersonProfile(6.1.0) | A person that is related to a patient, but who is not a direct target of care
active |  | 1..1 | boolean | (USCDI) Whether this related person's record is in active use
patient |  | 1..1 | Reference(US Quality Core Patient) | (USCDI) The patient this person is related to
relationship | C | 0..* | CodeableConcept | (USCDI+ Quality) (USCDI) The nature of the relationship
name | C | 0..* | HumanName | (USCDI+ Quality) (USCDI) A name associated with the person
telecom |  | 0..* | ContactPoint | (USCDI+ Quality) (USCDI) A contact detail for the person
address |  | 0..* | Address | (USCDI+ Quality) (USCDI) Address where the related person can be contacted or visited
Documentation for this format

Snapshot ViewView

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
RelatedPerson | C | 0..* | USCoreRelatedPersonProfile(6.1.0) | A person that is related to a patient, but who is not a direct target of care Constraints: us-core-14
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 0..* | Identifier | A human identifier for this person
active | ?!S Σ | 1..1 | boolean | (USCDI) Whether this related person's record is in active use
patient | S Σ | 1..1 | Reference(US Quality Core Patient) | (USCDI) The patient this person is related to
relationship | S Σ C | 0..* | CodeableConcept | (USCDI+ Quality) (USCDI) The nature of the relationship Binding: PatientRelationshipType (preferred): The nature of the relationship between a patient and the related person.
name | S Σ C | 0..* | HumanName | (USCDI+ Quality) (USCDI) A name associated with the person
telecom | S Σ | 0..* | ContactPoint | (USCDI+ Quality) (USCDI) A contact detail for the person
gender | Σ | 0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
birthDate | Σ | 0..1 | date | The date on which the related person was born
address | S Σ | 0..* | Address | (USCDI+ Quality) (USCDI) Address where the related person can be contacted or visited
photo |  | 0..* | Attachment | Image of the person
period |  | 0..1 | Period | Period of time that this relationship is considered valid
communication |  | 0..* | BackboneElement | A language which may be used to communicate with about the patient's health
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
language |  | 1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
preferred |  | 0..1 | boolean | Language preference indicator
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
RelatedPerson.language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.
RelatedPerson.relationship | Base | preferred | Patient relationship type | 📦4.0.1 | FHIR Std.
RelatedPerson.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std.
RelatedPerson.communication.​language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | RelatedPerson | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | RelatedPerson | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | RelatedPerson | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
us-core-14 | error | RelatedPerson | Either a name or a relationship SHALL be provided (or both) | `name.exists() or relationship.exists()`

Summary

Mandatory: 1 element

Structures

This structure refers to these other structures:

- US Quality Core Patient (http://fhir.org/guides/onc/us-quality-core/StructureDefinition/us-quality-core-patient)

Other representations of profile: CSV, Excel, Schematron