FHIR Clinical Documents
1.0.1 - STU 1 International flag

FHIR Clinical Documents, published by HL7 International / Structured Documents. This guide is not an authorized publication; it is the continuous build for version 1.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-clinical-document/ and changes regularly. See the Directory of published versions

Extension: Participant Extension

Official URL: http://hl7.org/fhir/uv/fhir-clinical-document/StructureDefinition/ParticipantExtension Version: 1.0.1
Standards status: Trial-use Active as of 2025-12-22 Maturity Level: 2 Computable Name: ParticipantExtension

Copyright/Legal: Used by permission of HL7 International, all rights reserved Creative Commons License

Participant Extension identifies supporting entities, including parents, relatives, caregivers, insurance policyholders, guarantors, and others related in some way to the patient. A supporting person or organization is an individual or an organization with a relationship to the patient. A supporting person who is playing multiple roles would be recorded in multiple participants (e.g., emergency contact and next-of-kin).

Context of Use

    This extension may be used on the following element(s)

Usage info

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Extension Content

Description Differentials, Snapshots, and other representations.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Participant Extension
... extension 2..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:type 1..* Extension Meaning and purpose of participation, in creation of the clinical document. The list includes: data entry person, informant, primary information recipient, and tracker. Other types are allowed.
..... extension 0..0 Extension
..... url 1..1 uri "type"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: FHIR Clinical Document Participant Types Value set (required): Contains particpants that are not a data-enter, information-recipient nor an informant. Additionally, the FHIR Clinical Document Composition Profile contains fields for AUT, AUTHEN, CST, LA, RCT, SBJ. Thus, these types are also not allowed as types in the Participant Extension.
.... extension:function 0..* Extension Exact function of the participant in the creation of the clinical document. This is more granular than type.
..... extension 0..0 Extension
..... url 1..1 uri "function"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: ParticipationFunction (extensible)
.... extension:time 0..1 Extension Time period of participation
..... extension 0..0 Extension
..... url 1..1 uri "time"
..... value[x] 1..1 Period Value of extension
.... extension:party S 1..1 Extension participant
..... extension 0..0 Extension
..... url 1..1 uri "party"
..... value[x] 1..1 Reference(Practitioner | PractitionerRole | Patient | RelatedPerson | Device | Organization) Value of extension
... url 1..1 uri "http://hl7.org/fhir/uv/fhir-clinical-document/StructureDefinition/ParticipantExtension"

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.extension:type.​value[x] Base required FHIR Clinical Document Participant Types Value set 📦1.0.0 THO v7.0
Extension.extension:function.​value[x] Base extensible ParticipationFunction 📦3.0.0 THO v7.0
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Participant Extension
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 2..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:type 1..* Extension Meaning and purpose of participation, in creation of the clinical document. The list includes: data entry person, informant, primary information recipient, and tracker. Other types are allowed.
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "type"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: FHIR Clinical Document Participant Types Value set (required): Contains particpants that are not a data-enter, information-recipient nor an informant. Additionally, the FHIR Clinical Document Composition Profile contains fields for AUT, AUTHEN, CST, LA, RCT, SBJ. Thus, these types are also not allowed as types in the Participant Extension.
.... extension:function 0..* Extension Exact function of the participant in the creation of the clinical document. This is more granular than type.
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "function"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: ParticipationFunction (extensible)
.... extension:time 0..1 Extension Time period of participation
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "time"
..... value[x] 1..1 Period Value of extension
.... extension:party S 1..1 Extension participant
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "party"
..... value[x] 1..1 Reference(Practitioner | PractitionerRole | Patient | RelatedPerson | Device | Organization) Value of extension
... url 1..1 uri "http://hl7.org/fhir/uv/fhir-clinical-document/StructureDefinition/ParticipantExtension"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:type.​value[x] Base required FHIR Clinical Document Participant Types Value set 📦1.0.0 THO v7.0
Extension.extension:function.​value[x] Base extensible ParticipationFunction 📦3.0.0 THO v7.0

Constraints

Id Grade Path(s) Description Expression
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()

Summary

Complex Extension: Participant Extension identifies supporting entities, including parents, relatives, caregivers, insurance policyholders, guarantors, and others related in some way to the patient. A supporting person or organization is an individual or an organization with a relationship to the patient. A supporting person who is playing multiple roles would be recorded in multiple participants (e.g., emergency contact and next-of-kin).

  • type: CodeableConcept: An Extension
  • function: CodeableConcept: An Extension
  • time: Period: An Extension
  • party: Reference: An Extension

Maturity: 2

Differential ViewDifferential View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Participant Extension
... extension 2..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:type 1..* Extension Meaning and purpose of participation, in creation of the clinical document. The list includes: data entry person, informant, primary information recipient, and tracker. Other types are allowed.
..... extension 0..0 Extension
..... url 1..1 uri "type"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: FHIR Clinical Document Participant Types Value set (required): Contains particpants that are not a data-enter, information-recipient nor an informant. Additionally, the FHIR Clinical Document Composition Profile contains fields for AUT, AUTHEN, CST, LA, RCT, SBJ. Thus, these types are also not allowed as types in the Participant Extension.
.... extension:function 0..* Extension Exact function of the participant in the creation of the clinical document. This is more granular than type.
..... extension 0..0 Extension
..... url 1..1 uri "function"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: ParticipationFunction (extensible)
.... extension:time 0..1 Extension Time period of participation
..... extension 0..0 Extension
..... url 1..1 uri "time"
..... value[x] 1..1 Period Value of extension
.... extension:party S 1..1 Extension participant
..... extension 0..0 Extension
..... url 1..1 uri "party"
..... value[x] 1..1 Reference(Practitioner | PractitionerRole | Patient | RelatedPerson | Device | Organization) Value of extension
... url 1..1 uri "http://hl7.org/fhir/uv/fhir-clinical-document/StructureDefinition/ParticipantExtension"

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.extension:type.​value[x] Base required FHIR Clinical Document Participant Types Value set 📦1.0.0 THO v7.0
Extension.extension:function.​value[x] Base extensible ParticipationFunction 📦3.0.0 THO v7.0

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Participant Extension
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 2..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:type 1..* Extension Meaning and purpose of participation, in creation of the clinical document. The list includes: data entry person, informant, primary information recipient, and tracker. Other types are allowed.
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "type"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: FHIR Clinical Document Participant Types Value set (required): Contains particpants that are not a data-enter, information-recipient nor an informant. Additionally, the FHIR Clinical Document Composition Profile contains fields for AUT, AUTHEN, CST, LA, RCT, SBJ. Thus, these types are also not allowed as types in the Participant Extension.
.... extension:function 0..* Extension Exact function of the participant in the creation of the clinical document. This is more granular than type.
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "function"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: ParticipationFunction (extensible)
.... extension:time 0..1 Extension Time period of participation
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "time"
..... value[x] 1..1 Period Value of extension
.... extension:party S 1..1 Extension participant
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "party"
..... value[x] 1..1 Reference(Practitioner | PractitionerRole | Patient | RelatedPerson | Device | Organization) Value of extension
... url 1..1 uri "http://hl7.org/fhir/uv/fhir-clinical-document/StructureDefinition/ParticipantExtension"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:type.​value[x] Base required FHIR Clinical Document Participant Types Value set 📦1.0.0 THO v7.0
Extension.extension:function.​value[x] Base extensible ParticipationFunction 📦3.0.0 THO v7.0

Constraints

Id Grade Path(s) Description Expression
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()

Summary

Complex Extension: Participant Extension identifies supporting entities, including parents, relatives, caregivers, insurance policyholders, guarantors, and others related in some way to the patient. A supporting person or organization is an individual or an organization with a relationship to the patient. A supporting person who is playing multiple roles would be recorded in multiple participants (e.g., emergency contact and next-of-kin).

  • type: CodeableConcept: An Extension
  • function: CodeableConcept: An Extension
  • time: Period: An Extension
  • party: Reference: An Extension

Maturity: 2

 

Other representations of profile: CSV, Excel, Schematron