Composition

Foundation

A set of healthcare-related information that is assembled together into a single logical package that provides a single coherent statement of meaning, establishes its own context and that has clinical attestation with regard to who is making the statement. A Composition defines the structure and narrative content necessary for a document. However, a Composition alone does not constitute a document. Rather, the Composition must be the first entry in a Bundle where Bundle.type=document, and any other resources referenced from Composition must be included as subsequent entries in the Bundle (for example Patient, Practitioner, Encounter, etc.).

Composition is a FHIR R4 Foundation resource — a set of resources composed into a single coherent clinical statement with clinical. It defines 54 elements and supports 27 search parameters, and is referenced from 5 elements across other resources.

Official spec

Path	Card.	Type	Description & Constraints
Composition	0..*	—	A set of resources composed into a single coherent clinical statement with clinical attestation
.idΣ	0..1	String	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 Bindinglanguages(preferred)
.text	0..1	Narrative	Text summary of the resource, for human interpretation
.contained	0..*	Resource	Contained, inline Resources
.extension	0..*	Extension	Additional content defined by implementations
.modifierExtension?!	0..*	Extension	Extensions that cannot be ignored
.identifierΣ	0..1	Identifier	Version-independent identifier for the Composition
.status?!Σ	1..1	code	preliminary \| final \| amended \| entered-in-error Bindingcomposition-status(required)
.typeΣ	1..1	CodeableConcept	Kind of composition (LOINC if possible) Bindingdoc-typecodes(preferred)
.categoryΣ	0..*	CodeableConcept	Categorization of Composition Bindingdocument-classcodes(example)
.subjectΣ	0..1	Reference(Resource)	Who and/or what the composition is about
.encounterΣ	0..1	Reference(Encounter)	Context of the Composition
.dateΣ	1..1	dateTime	Composition editing time
.authorΣ	1..*	Reference(Practitioner \| PractitionerRole \| Device \| Patient \| RelatedPerson \| Organization)	Who and/or what authored the composition
.titleΣ	1..1	string	Human Readable name/title
.confidentialityΣ	0..1	code	As defined by affinity domain Bindingv3-ConfidentialityClassification(required)
.attester	0..*	BackboneElement	Attests to accuracy of composition
.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
.mode	1..1	code	personal \| professional \| legal \| official Bindingcomposition-attestation-mode(required)
.time	0..1	dateTime	When the composition was attested
.party	0..1	Reference(Patient \| RelatedPerson \| Practitioner \| PractitionerRole \| Organization)	Who attested the composition
.custodianΣ	0..1	Reference(Organization)	Organization which maintains the composition
.relatesTo	0..*	BackboneElement	Relationships to other compositions/documents
.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
.code	1..1	code	replaces \| transforms \| signs \| appends Bindingdocument-relationship-type(required)
.target[x]	1..1	Identifier \| Reference(Composition)	Target of the relationship
.eventΣ	0..*	BackboneElement	The clinical service(s) being documented
.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
.codeΣ	0..*	CodeableConcept	Code(s) that apply to the event being documented Bindingv3-ActCode(example)
.periodΣ	0..1	Period	The period covered by the documentation
.detailΣ	0..*	Reference(Resource)	The event(s) being documented
.section	0..*	BackboneElement	Composition is broken into sections
.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
.title	0..1	string	Label for section (e.g. for ToC)
.code	0..1	CodeableConcept	Classification of section (recommended) Bindingdoc-section-codes(example)
.author	0..*	Reference(Practitioner \| PractitionerRole \| Device \| Patient \| RelatedPerson \| Organization)	Who and/or what authored the section
.focus	0..1	Reference(Resource)	Who/what the section is about, when it is not about the subject of composition
.text	0..1	Narrative	Text summary of the section, for human interpretation
.mode	0..1	code	working \| snapshot \| changes Bindinglist-mode(required)
.orderedBy	0..1	CodeableConcept	Order of section entries Bindinglist-order(preferred)
.entry	0..*	Reference(Resource)	A reference to data that supports this section
.emptyReason	0..1	CodeableConcept	Why the section is empty Bindinglist-empty-reason(preferred)
.section	0..*	—	Nested Section

More Foundation resources