Healthy Route Implementation Guide
0.1.0 - ci-build

Healthy Route Implementation Guide, published by Savannah Informatics. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/savannahghi/healthy-route-ig/ and changes regularly. See the Directory of published versions

Resource Profile: Healthy Route Document

Official URL: https://fhir.savannahghi.org/ig/healthy-route/StructureDefinition/hr-document-reference Version: 0.1.0
Draft as of 2026-10-11 Computable Name: HRDocumentReference

Any document held by the study, in the form common to all of them.

Carries the constraints that hold for every document regardless of its purpose, so that they are inherited rather than restated. Profiles derived from it narrow it to a particular kind of document; it is usable directly for documents that need no further constraint.

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: doco
DocumentReference C 0..* DocumentReference A reference to a document
Constraints: docRef-1, docRef-2
DocumentReference.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
DocumentReference.contained 0..* Resource Contained, inline Resources
DocumentReference.Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
DocumentReference.Slices for extension.extension:tenant This element must be supported. 1..1 Identifier Owning site tenant
URL: https://fhir.savannahghi.org/ig/healthy-route/StructureDefinition/hr-tenant
DocumentReference.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored
DocumentReference.status This element is a modifier element. This element must be supported. This element is included in summaries. 1..1 code current | superseded | entered-in-error
Binding: DocumentReferenceStatus (required): The status of the document reference.
DocumentReference.subject This element must be supported. This element is included in summaries. 0..1 Reference(Healthy Route Patient) Who/what is the subject of the document
DocumentReference.context C 0..* Reference(Appointment | Encounter | EpisodeOfCare) Context of the document content
DocumentReference.date This element must be supported. This element is included in summaries. 1..1 instant When the document was registered
DocumentReference.custodian This element must be supported. 1..1 Reference(Healthy Route Organization) Organisation holding the original
DocumentReference.content This element must be supported. This element is included in summaries. 1..* BackboneElement Document referenced
DocumentReference.content.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
DocumentReference.content.attachment This element must be supported. This element is included in summaries. 1..1 Attachment Where to access the document
DocumentReference.content.attachment.contentType This element must be supported. This element is included in summaries. C 1..1 code Mime type of the content, with charset etc.
Binding: MimeTypes (required): BCP 13 (RFCs 2045, 2046, 2047, 4288, 4289 and 2049)
Example General: text/plain; charset=UTF-8, image/png
DocumentReference.content.attachment.url This element must be supported. This element is included in summaries. 1..1 url Uri where the data can be found
Example General: http://www.acme.com/logo-small.png
DocumentReference.content.attachment.hash This element must be supported. This element is included in summaries. 0..1 base64Binary SHA-1 hash of the file

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
DocumentReference.status Base required DocumentReferenceStatus 📍5.0.0 FHIR Std.
DocumentReference.content.​attachment.contentType Base required Mime Types 📍5.0.0 FHIR Std.

Constraints

Id Grade Path(s) Description Expression

This structure is derived from DocumentReference

NameFlagsCard.TypeDescription & Constraints    Filter: doco
DocumentReference 0..* DocumentReference A reference to a document
DocumentReference.Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
DocumentReference.Slices for extension.extension:tenant This element must be supported. 1..1 Identifier Owning site tenant
URL: https://fhir.savannahghi.org/ig/healthy-route/StructureDefinition/hr-tenant
DocumentReference.status This element must be supported. 1..1 code current | superseded | entered-in-error
DocumentReference.subject This element must be supported. 0..1 Reference(Healthy Route Patient) Who/what is the subject of the document
DocumentReference.custodian This element must be supported. 1..1 Reference(Healthy Route Organization) Organisation holding the original
DocumentReference.content This element must be supported. 1..* BackboneElement Document referenced
DocumentReference.content.attachment This element must be supported. 1..1 Attachment Where to access the document
DocumentReference.content.attachment.contentType This element must be supported. 1..1 code Mime type of the content, with charset etc.
DocumentReference.content.attachment.data 0..0 Data inline, base64ed
DocumentReference.content.attachment.url This element must be supported. 1..1 url Uri where the data can be found
DocumentReference.content.attachment.hash This element must be supported. 0..1 base64Binary SHA-1 hash of the file

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: doco
DocumentReference C 0..* DocumentReference A reference to a document
Constraints: docRef-1, docRef-2
DocumentReference.id This element is included in summaries. 0..1 id Logical id of this artifact
DocumentReference.meta This element is included in summaries. 0..1 Meta Metadata about the resource
DocumentReference.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
DocumentReference.language 0..1 code Language of the resource content
Binding: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
DocumentReference.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
DocumentReference.contained 0..* Resource Contained, inline Resources
DocumentReference.Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
DocumentReference.Slices for extension.extension:tenant This element must be supported. 1..1 Identifier Owning site tenant
URL: https://fhir.savannahghi.org/ig/healthy-route/StructureDefinition/hr-tenant
DocumentReference.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored
DocumentReference.identifier This element is included in summaries. 0..* Identifier Business identifiers for the document
DocumentReference.version This element is included in summaries. 0..1 string An explicitly assigned identifer of a variation of the content in the DocumentReference
DocumentReference.basedOn 0..* Reference(Appointment | AppointmentResponse | CarePlan | Claim | CommunicationRequest | Contract | CoverageEligibilityRequest | DeviceRequest | EnrollmentRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | RequestOrchestration | ServiceRequest | SupplyRequest | VisionPrescription) Procedure that caused this media to be created
DocumentReference.status This element is a modifier element. This element must be supported. This element is included in summaries. 1..1 code current | superseded | entered-in-error
Binding: DocumentReferenceStatus (required): The status of the document reference.
DocumentReference.docStatus This element is included in summaries. 0..1 code registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
Binding: CompositionStatus (required): Status of the underlying document.
DocumentReference.modality This element is included in summaries. 0..* CodeableConcept Imaging modality used
Binding: Modality (extensible): Type of acquired data in the instance.
DocumentReference.type This element is included in summaries. 0..1 CodeableConcept Kind of document (LOINC if possible)
Binding: FHIRDocumentTypeCodes (preferred): Precise type of clinical document.
DocumentReference.category This element is included in summaries. 0..* CodeableConcept Categorization of document
Binding: ReferencedItemCategoryValueSet (example): High-level kind of document at a macro level.
DocumentReference.subject This element must be supported. This element is included in summaries. 0..1 Reference(Healthy Route Patient) Who/what is the subject of the document
DocumentReference.context C 0..* Reference(Appointment | Encounter | EpisodeOfCare) Context of the document content
DocumentReference.event 0..* CodeableReference() Main clinical acts documented
Binding: v3 Code System ActCode (example): This list of codes represents the main clinical acts being documented.
DocumentReference.bodySite This element is included in summaries. 0..* CodeableReference(BodyStructure) Body part included
Binding: SNOMEDCTBodyStructures (example): SNOMED CT Body site concepts
DocumentReference.facilityType C 0..1 CodeableConcept Kind of facility where patient was seen
Binding: FacilityTypeCodeValueSet (example): XDS Facility Type.
DocumentReference.practiceSetting C 0..1 CodeableConcept Additional details about where the content was created (e.g. clinical specialty)
Binding: PracticeSettingCodeValueSet (example): Additional details about where the content was created (e.g. clinical specialty).
DocumentReference.period This element is included in summaries. 0..1 Period Time of service that is being documented
DocumentReference.date This element must be supported. This element is included in summaries. 1..1 instant When the document was registered
DocumentReference.author This element is included in summaries. 0..* Reference(Practitioner | PractitionerRole | Organization | Device | Patient | RelatedPerson | CareTeam) Who and/or what authored the document
DocumentReference.attester 0..* BackboneElement Attests to accuracy of the document
DocumentReference.attester.id 0..1 string Unique id for inter-element referencing
DocumentReference.attester.extension 0..* Extension Additional content defined by implementations
DocumentReference.attester.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
DocumentReference.attester.mode 1..1 CodeableConcept personal | professional | legal | official
Binding: CompositionAttestationMode (preferred): The way in which a person authenticated a document.
DocumentReference.attester.time 0..1 dateTime When the document was attested
DocumentReference.attester.party 0..1 Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization) Who attested the document
DocumentReference.custodian This element must be supported. 1..1 Reference(Healthy Route Organization) Organisation holding the original
DocumentReference.relatesTo This element is included in summaries. 0..* BackboneElement Relationships to other documents
DocumentReference.relatesTo.id 0..1 string Unique id for inter-element referencing
DocumentReference.relatesTo.extension 0..* Extension Additional content defined by implementations
DocumentReference.relatesTo.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
DocumentReference.relatesTo.code This element is included in summaries. 1..1 CodeableConcept The relationship type with another document
Binding: DocumentRelationshipType (extensible): The type of relationship between the documents.
DocumentReference.relatesTo.target This element is included in summaries. 1..1 Reference(DocumentReference) Target of the relationship
DocumentReference.description This element is included in summaries. 0..1 markdown Human-readable description
DocumentReference.securityLabel This element is included in summaries. 0..* CodeableConcept Document security-tags
Binding: SecurityLabelExamples (example): Example Security Labels from the Healthcare Privacy and Security Classification System.
DocumentReference.content This element must be supported. This element is included in summaries. 1..* BackboneElement Document referenced
DocumentReference.content.id 0..1 string Unique id for inter-element referencing
DocumentReference.content.extension 0..* Extension Additional content defined by implementations
DocumentReference.content.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
DocumentReference.content.attachment This element must be supported. This element is included in summaries. 1..1 Attachment Where to access the document
DocumentReference.content.attachment.id 0..1 id Unique id for inter-element referencing
DocumentReference.content.attachment.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
DocumentReference.content.attachment.contentType This element must be supported. This element is included in summaries. C 1..1 code Mime type of the content, with charset etc.
Binding: MimeTypes (required): BCP 13 (RFCs 2045, 2046, 2047, 4288, 4289 and 2049)
Example General: text/plain; charset=UTF-8, image/png
DocumentReference.content.attachment.language This element is included in summaries. 0..1 code Human language of the content (BCP-47)
Binding: AllLanguages (required): IETF language tag for a human language.
Additional BindingsPurpose
CommonLanguages Starter

Example General: en-AU
DocumentReference.content.attachment.url This element must be supported. This element is included in summaries. 1..1 url Uri where the data can be found
Example General: http://www.acme.com/logo-small.png
DocumentReference.content.attachment.size This element is included in summaries. 0..1 integer64 Number of bytes of content (if url provided)
DocumentReference.content.attachment.hash This element must be supported. This element is included in summaries. 0..1 base64Binary SHA-1 hash of the file
DocumentReference.content.attachment.title This element is included in summaries. 0..1 string Label to display in place of the data
Example General: Official Corporate Logo
DocumentReference.content.attachment.creation This element is included in summaries. 0..1 dateTime Date attachment was first created
DocumentReference.content.attachment.height 0..1 positiveInt Height of the image in pixels (photo/video)
DocumentReference.content.attachment.width 0..1 positiveInt Width of the image in pixels (photo/video)
DocumentReference.content.attachment.frames 0..1 positiveInt Number of frames if > 1 (photo)
DocumentReference.content.attachment.duration 0..1 decimal Length in seconds (audio / video)
DocumentReference.content.attachment.pages 0..1 positiveInt Number of printed pages
DocumentReference.content.profile This element is included in summaries. 0..* BackboneElement Content profile rules for the document
DocumentReference.content.profile.id 0..1 string Unique id for inter-element referencing
DocumentReference.content.profile.extension 0..* Extension Additional content defined by implementations
DocumentReference.content.profile.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
DocumentReference.content.profile.value[x] This element is included in summaries. 1..1 Code|uri|canonical
Binding: HL7 ValueSet of Format Codes for use with Document Sharing (preferred): Document Format Codes.
DocumentReference.content.profile.value[x].valueCoding Coding
DocumentReference.content.profile.value[x].valueUri uri
DocumentReference.content.profile.value[x].valueCanonical canonical(Any)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
DocumentReference.language Base required All Languages 📍5.0.0 FHIR Std.
DocumentReference.status Base required DocumentReferenceStatus 📍5.0.0 FHIR Std.
DocumentReference.docStatus Base required Composition Status 📍5.0.0 FHIR Std.
DocumentReference.modality Base extensible Modality ⏿2025.3.20250714 tx.fhir.org
DocumentReference.type Base preferred FHIR Document Type Codes 📍5.0.0 FHIR Std.
DocumentReference.category Base example Referenced Item Category Value Set 📍5.0.0 FHIR Std.
DocumentReference.event Base example v3 Code System ActCode 📦3.0.0 THO v7.4
DocumentReference.bodySite Base example SNOMED CT Body Structures 📍5.0.0 FHIR Std.
DocumentReference.facilityType Base example Facility Type Code Value Set 📍5.0.0 FHIR Std.
DocumentReference.practiceSetting Base example Practice Setting Code Value Set 📍5.0.0 FHIR Std.
DocumentReference.attester.​mode Base preferred Composition Attestation Mode 📍5.0.0 FHIR Std.
DocumentReference.relatesTo.​code Base extensible Document Relationship Type 📍5.0.0 FHIR Std.
DocumentReference.securityLabel Base example Example set of Security Labels 📍5.0.0 FHIR Std.
DocumentReference.content.​attachment.contentType Base required Mime Types 📍5.0.0 FHIR Std.
DocumentReference.content.​attachment.language Base required All Languages 📍5.0.0 FHIR Std.
DocumentReference.content.​profile.value[x] Base preferred HL7 ValueSet of Format Codes for use with Document Sharing 📦2.1.0 THO v7.4

Constraints

Id Grade Path(s) Description Expression

This structure is derived from DocumentReference

Summary

Mandatory: 6 elements
Must-Support: 10 elements
Prohibited: 1 element

Structures

This structure refers to these other structures:

Extensions

This structure refers to these extensions:

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
DocumentReference C 0..* DocumentReference A reference to a document
Constraints: docRef-1, docRef-2
DocumentReference.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
DocumentReference.contained 0..* Resource Contained, inline Resources
DocumentReference.Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
DocumentReference.Slices for extension.extension:tenant This element must be supported. 1..1 Identifier Owning site tenant
URL: https://fhir.savannahghi.org/ig/healthy-route/StructureDefinition/hr-tenant
DocumentReference.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored
DocumentReference.status This element is a modifier element. This element must be supported. This element is included in summaries. 1..1 code current | superseded | entered-in-error
Binding: DocumentReferenceStatus (required): The status of the document reference.
DocumentReference.subject This element must be supported. This element is included in summaries. 0..1 Reference(Healthy Route Patient) Who/what is the subject of the document
DocumentReference.context C 0..* Reference(Appointment | Encounter | EpisodeOfCare) Context of the document content
DocumentReference.date This element must be supported. This element is included in summaries. 1..1 instant When the document was registered
DocumentReference.custodian This element must be supported. 1..1 Reference(Healthy Route Organization) Organisation holding the original
DocumentReference.content This element must be supported. This element is included in summaries. 1..* BackboneElement Document referenced
DocumentReference.content.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
DocumentReference.content.attachment This element must be supported. This element is included in summaries. 1..1 Attachment Where to access the document
DocumentReference.content.attachment.contentType This element must be supported. This element is included in summaries. C 1..1 code Mime type of the content, with charset etc.
Binding: MimeTypes (required): BCP 13 (RFCs 2045, 2046, 2047, 4288, 4289 and 2049)
Example General: text/plain; charset=UTF-8, image/png
DocumentReference.content.attachment.url This element must be supported. This element is included in summaries. 1..1 url Uri where the data can be found
Example General: http://www.acme.com/logo-small.png
DocumentReference.content.attachment.hash This element must be supported. This element is included in summaries. 0..1 base64Binary SHA-1 hash of the file

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
DocumentReference.status Base required DocumentReferenceStatus 📍5.0.0 FHIR Std.
DocumentReference.content.​attachment.contentType Base required Mime Types 📍5.0.0 FHIR Std.

Constraints

Id Grade Path(s) Description Expression

Differential View

This structure is derived from DocumentReference

NameFlagsCard.TypeDescription & Constraints    Filter: doco
DocumentReference 0..* DocumentReference A reference to a document
DocumentReference.Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
DocumentReference.Slices for extension.extension:tenant This element must be supported. 1..1 Identifier Owning site tenant
URL: https://fhir.savannahghi.org/ig/healthy-route/StructureDefinition/hr-tenant
DocumentReference.status This element must be supported. 1..1 code current | superseded | entered-in-error
DocumentReference.subject This element must be supported. 0..1 Reference(Healthy Route Patient) Who/what is the subject of the document
DocumentReference.date This element must be supported. 1..1 instant When the document was registered
DocumentReference.custodian This element must be supported. 1..1 Reference(Healthy Route Organization) Organisation holding the original
DocumentReference.content This element must be supported. 1..* BackboneElement Document referenced
DocumentReference.content.attachment This element must be supported. 1..1 Attachment Where to access the document
DocumentReference.content.attachment.contentType This element must be supported. 1..1 code Mime type of the content, with charset etc.
DocumentReference.content.attachment.data 0..0 Data inline, base64ed
DocumentReference.content.attachment.url This element must be supported. 1..1 url Uri where the data can be found
DocumentReference.content.attachment.hash This element must be supported. 0..1 base64Binary SHA-1 hash of the file

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
DocumentReference C 0..* DocumentReference A reference to a document
Constraints: docRef-1, docRef-2
DocumentReference.id This element is included in summaries. 0..1 id Logical id of this artifact
DocumentReference.meta This element is included in summaries. 0..1 Meta Metadata about the resource
DocumentReference.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
DocumentReference.language 0..1 code Language of the resource content
Binding: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
DocumentReference.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
DocumentReference.contained 0..* Resource Contained, inline Resources
DocumentReference.Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
DocumentReference.Slices for extension.extension:tenant This element must be supported. 1..1 Identifier Owning site tenant
URL: https://fhir.savannahghi.org/ig/healthy-route/StructureDefinition/hr-tenant
DocumentReference.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored
DocumentReference.identifier This element is included in summaries. 0..* Identifier Business identifiers for the document
DocumentReference.version This element is included in summaries. 0..1 string An explicitly assigned identifer of a variation of the content in the DocumentReference
DocumentReference.basedOn 0..* Reference(Appointment | AppointmentResponse | CarePlan | Claim | CommunicationRequest | Contract | CoverageEligibilityRequest | DeviceRequest | EnrollmentRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | RequestOrchestration | ServiceRequest | SupplyRequest | VisionPrescription) Procedure that caused this media to be created
DocumentReference.status This element is a modifier element. This element must be supported. This element is included in summaries. 1..1 code current | superseded | entered-in-error
Binding: DocumentReferenceStatus (required): The status of the document reference.
DocumentReference.docStatus This element is included in summaries. 0..1 code registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
Binding: CompositionStatus (required): Status of the underlying document.
DocumentReference.modality This element is included in summaries. 0..* CodeableConcept Imaging modality used
Binding: Modality (extensible): Type of acquired data in the instance.
DocumentReference.type This element is included in summaries. 0..1 CodeableConcept Kind of document (LOINC if possible)
Binding: FHIRDocumentTypeCodes (preferred): Precise type of clinical document.
DocumentReference.category This element is included in summaries. 0..* CodeableConcept Categorization of document
Binding: ReferencedItemCategoryValueSet (example): High-level kind of document at a macro level.
DocumentReference.subject This element must be supported. This element is included in summaries. 0..1 Reference(Healthy Route Patient) Who/what is the subject of the document
DocumentReference.context C 0..* Reference(Appointment | Encounter | EpisodeOfCare) Context of the document content
DocumentReference.event 0..* CodeableReference() Main clinical acts documented
Binding: v3 Code System ActCode (example): This list of codes represents the main clinical acts being documented.
DocumentReference.bodySite This element is included in summaries. 0..* CodeableReference(BodyStructure) Body part included
Binding: SNOMEDCTBodyStructures (example): SNOMED CT Body site concepts
DocumentReference.facilityType C 0..1 CodeableConcept Kind of facility where patient was seen
Binding: FacilityTypeCodeValueSet (example): XDS Facility Type.
DocumentReference.practiceSetting C 0..1 CodeableConcept Additional details about where the content was created (e.g. clinical specialty)
Binding: PracticeSettingCodeValueSet (example): Additional details about where the content was created (e.g. clinical specialty).
DocumentReference.period This element is included in summaries. 0..1 Period Time of service that is being documented
DocumentReference.date This element must be supported. This element is included in summaries. 1..1 instant When the document was registered
DocumentReference.author This element is included in summaries. 0..* Reference(Practitioner | PractitionerRole | Organization | Device | Patient | RelatedPerson | CareTeam) Who and/or what authored the document
DocumentReference.attester 0..* BackboneElement Attests to accuracy of the document
DocumentReference.attester.id 0..1 string Unique id for inter-element referencing
DocumentReference.attester.extension 0..* Extension Additional content defined by implementations
DocumentReference.attester.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
DocumentReference.attester.mode 1..1 CodeableConcept personal | professional | legal | official
Binding: CompositionAttestationMode (preferred): The way in which a person authenticated a document.
DocumentReference.attester.time 0..1 dateTime When the document was attested
DocumentReference.attester.party 0..1 Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization) Who attested the document
DocumentReference.custodian This element must be supported. 1..1 Reference(Healthy Route Organization) Organisation holding the original
DocumentReference.relatesTo This element is included in summaries. 0..* BackboneElement Relationships to other documents
DocumentReference.relatesTo.id 0..1 string Unique id for inter-element referencing
DocumentReference.relatesTo.extension 0..* Extension Additional content defined by implementations
DocumentReference.relatesTo.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
DocumentReference.relatesTo.code This element is included in summaries. 1..1 CodeableConcept The relationship type with another document
Binding: DocumentRelationshipType (extensible): The type of relationship between the documents.
DocumentReference.relatesTo.target This element is included in summaries. 1..1 Reference(DocumentReference) Target of the relationship
DocumentReference.description This element is included in summaries. 0..1 markdown Human-readable description
DocumentReference.securityLabel This element is included in summaries. 0..* CodeableConcept Document security-tags
Binding: SecurityLabelExamples (example): Example Security Labels from the Healthcare Privacy and Security Classification System.
DocumentReference.content This element must be supported. This element is included in summaries. 1..* BackboneElement Document referenced
DocumentReference.content.id 0..1 string Unique id for inter-element referencing
DocumentReference.content.extension 0..* Extension Additional content defined by implementations
DocumentReference.content.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
DocumentReference.content.attachment This element must be supported. This element is included in summaries. 1..1 Attachment Where to access the document
DocumentReference.content.attachment.id 0..1 id Unique id for inter-element referencing
DocumentReference.content.attachment.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
DocumentReference.content.attachment.contentType This element must be supported. This element is included in summaries. C 1..1 code Mime type of the content, with charset etc.
Binding: MimeTypes (required): BCP 13 (RFCs 2045, 2046, 2047, 4288, 4289 and 2049)
Example General: text/plain; charset=UTF-8, image/png
DocumentReference.content.attachment.language This element is included in summaries. 0..1 code Human language of the content (BCP-47)
Binding: AllLanguages (required): IETF language tag for a human language.
Additional BindingsPurpose
CommonLanguages Starter

Example General: en-AU
DocumentReference.content.attachment.url This element must be supported. This element is included in summaries. 1..1 url Uri where the data can be found
Example General: http://www.acme.com/logo-small.png
DocumentReference.content.attachment.size This element is included in summaries. 0..1 integer64 Number of bytes of content (if url provided)
DocumentReference.content.attachment.hash This element must be supported. This element is included in summaries. 0..1 base64Binary SHA-1 hash of the file
DocumentReference.content.attachment.title This element is included in summaries. 0..1 string Label to display in place of the data
Example General: Official Corporate Logo
DocumentReference.content.attachment.creation This element is included in summaries. 0..1 dateTime Date attachment was first created
DocumentReference.content.attachment.height 0..1 positiveInt Height of the image in pixels (photo/video)
DocumentReference.content.attachment.width 0..1 positiveInt Width of the image in pixels (photo/video)
DocumentReference.content.attachment.frames 0..1 positiveInt Number of frames if > 1 (photo)
DocumentReference.content.attachment.duration 0..1 decimal Length in seconds (audio / video)
DocumentReference.content.attachment.pages 0..1 positiveInt Number of printed pages
DocumentReference.content.profile This element is included in summaries. 0..* BackboneElement Content profile rules for the document
DocumentReference.content.profile.id 0..1 string Unique id for inter-element referencing
DocumentReference.content.profile.extension 0..* Extension Additional content defined by implementations
DocumentReference.content.profile.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
DocumentReference.content.profile.value[x] This element is included in summaries. 1..1 Code|uri|canonical
Binding: HL7 ValueSet of Format Codes for use with Document Sharing (preferred): Document Format Codes.
DocumentReference.content.profile.value[x].valueCoding Coding
DocumentReference.content.profile.value[x].valueUri uri
DocumentReference.content.profile.value[x].valueCanonical canonical(Any)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
DocumentReference.language Base required All Languages 📍5.0.0 FHIR Std.
DocumentReference.status Base required DocumentReferenceStatus 📍5.0.0 FHIR Std.
DocumentReference.docStatus Base required Composition Status 📍5.0.0 FHIR Std.
DocumentReference.modality Base extensible Modality ⏿2025.3.20250714 tx.fhir.org
DocumentReference.type Base preferred FHIR Document Type Codes 📍5.0.0 FHIR Std.
DocumentReference.category Base example Referenced Item Category Value Set 📍5.0.0 FHIR Std.
DocumentReference.event Base example v3 Code System ActCode 📦3.0.0 THO v7.4
DocumentReference.bodySite Base example SNOMED CT Body Structures 📍5.0.0 FHIR Std.
DocumentReference.facilityType Base example Facility Type Code Value Set 📍5.0.0 FHIR Std.
DocumentReference.practiceSetting Base example Practice Setting Code Value Set 📍5.0.0 FHIR Std.
DocumentReference.attester.​mode Base preferred Composition Attestation Mode 📍5.0.0 FHIR Std.
DocumentReference.relatesTo.​code Base extensible Document Relationship Type 📍5.0.0 FHIR Std.
DocumentReference.securityLabel Base example Example set of Security Labels 📍5.0.0 FHIR Std.
DocumentReference.content.​attachment.contentType Base required Mime Types 📍5.0.0 FHIR Std.
DocumentReference.content.​attachment.language Base required All Languages 📍5.0.0 FHIR Std.
DocumentReference.content.​profile.value[x] Base preferred HL7 ValueSet of Format Codes for use with Document Sharing 📦2.1.0 THO v7.4

Constraints

Id Grade Path(s) Description Expression

This structure is derived from DocumentReference

Summary

Mandatory: 6 elements
Must-Support: 10 elements
Prohibited: 1 element

Structures

This structure refers to these other structures:

Extensions

This structure refers to these extensions:

 

Other representations of profile: CSV, Excel, Schematron