Uzbekistan Digital Health Platform
0.13.0 - ci-build Uzbekistan flag

Uzbekistan Digital Health Platform, published by Ministry of Health of the Republic of Uzbekistan. This guide is not an authorized publication; it is the continuous build for version 0.13.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/uzinfocom-org/digital-health-ig/ and changes regularly. See the Directory of published versions

Resource Profile: UZ Core Composition ( Experimental )

Official URL: https://dhp.uz/fhir/core/StructureDefinition/uz-core-composition Version: 0.13.0
Active as of 2026-03-05 Computable Name: UZCoreComposition

UZ Core Composition profile, used as a foundation for creating medical documents and digital forms

UZ Core Composition is the header of a medical document or digital form: a patient's medical record, a register, a certificate, a signed report. It says what kind of document it is (type, from the national list of medical document forms), whom it is about, who wrote it, who attested it and which organization keeps it, and it organises the content into titled sections. Each section has a human-readable text and references the resources that hold the data, such as a Condition, an Observation or a DiagnosticReport; the Composition points to them rather than copying them. A finalised document is sent as a document Bundle with the Composition as its first entry and signed through a Provenance; how documents are assembled and signed is specified in the DHP Integrations IG. Store ongoing clinical facts as their own resources, and use a Composition only when you need a finalised document.

Mandatory and Must Support data elements

The elements below must always be present (mandatory) or must be supported when the data is available (Must Support). Not all of them are required, but your system must populate each Must Support element when it has the data, and process it on receipt. This is the human-readable summary; the formal views below give the exact cardinalities, types and terminology bindings.

Each UZ Core Composition Must Have

  • a status (preliminary / final / amended / entered-in-error …);
  • the document type;
  • the date the document was last edited;
  • at least one author;
  • a title.

These all come from the base resource. Each attester must have a mode, and each section text, when present, must have a status and a div.

Each UZ Core Composition Must Support

  • the status and the document type (the form from the national list of medical documents);
  • the document category (medical record / register / form);
  • whom the document is about (subject), usually the patient;
  • the date, the authors (practitioner, role, organization, related person, patient or device) and the title;
  • the attesters: how they attested (personal / professional / legal / official) and who they are (party);
  • the organization that keeps the document (custodian);
  • the sections, each with its title, code, author, narrative text, the order of its entries (orderedBy), the entry references, and why it is empty (emptyReason).

Building the JSON, step by step

The examples below go from the smallest valid Composition to one with sections. Each one validates against this profile. The complete reference instance is the medical record composition.

The smallest Composition you should send

A Composition needs a status, a type, a date, an author and a title:

{
  "resourceType": "Composition",
  "meta": { "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-composition"] },
  "language": "uz",
  "status": "final",
  "type": {
    "coding": [
      {
        "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/composition-type-cs",
        "code": "emdoc-0010-0003",
        "display": "BEMORNING TIBBIY KARTASI №"
      }
    ]
  },
  "date": "2026-03-05T10:00:00+05:00",
  "author": [ { "reference": "PractitionerRole/example-practitionerrole" } ],
  "title": "Bemorning elektron tibbiy kartasi"
}

type must come from the national medical document types, here emdoc-0010-0003 (patient medical record). That code system is in Uzbek, so a display you send must be the Uzbek one and the resource must say "language": "uz"; or leave display out. date changes whenever the document is edited; author repeats when several people or systems wrote it.

Subject, attester and custodian

A medical record is about a patient, is attested by the clinician responsible for it, and is kept by a health facility:

{
  "resourceType": "Composition",
  "meta": { "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-composition"] },
  "language": "uz",
  "status": "final",
  "type": {
    "coding": [
      {
        "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/composition-type-cs",
        "code": "emdoc-0010-0003",
        "display": "BEMORNING TIBBIY KARTASI №"
      }
    ]
  },
  "category": [
    {
      "coding": [
        {
          "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/composition-category-cs",
          "code": "Comp-001-0001",
          "display": "Tibbiy karta"
        }
      ]
    }
  ],
  "subject": [ { "reference": "Patient/example-salim" } ],
  "date": "2026-03-05T10:00:00+05:00",
  "author": [ { "reference": "PractitionerRole/example-practitionerrole" } ],
  "title": "Bemorning elektron tibbiy kartasi",
  "attester": [
    {
      "mode": { "coding": [ { "system": "http://hl7.org/fhir/composition-attestation-mode", "code": "legal" } ] },
      "time": "2026-03-05T10:15:00+05:00",
      "party": { "reference": "PractitionerRole/example-practitionerrole" }
    }
  ],
  "custodian": { "reference": "Organization/tashkent-hospital" }
}

category takes a code from the national document categories (medical record / register / form); codes from other systems may sit beside it. attester.mode is required whenever an attester is given. The attestation is a statement in the document; the digital signature that gives it legal force is a separate Provenance.

Adding sections

Each section has a title, a code saying what it contains, a narrative text, and entry references to the resources behind it. A section with nothing to report keeps its text and gives an emptyReason instead of entries:

{
  "resourceType": "Composition",
  "meta": { "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-composition"] },
  "language": "uz",
  "status": "final",
  "type": {
    "coding": [
      { "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/composition-type-cs", "code": "emdoc-0010-0003" }
    ]
  },
  "subject": [ { "reference": "Patient/example-salim" } ],
  "date": "2026-03-05T10:00:00+05:00",
  "author": [ { "reference": "PractitionerRole/example-practitionerrole" } ],
  "title": "Bemorning elektron tibbiy kartasi",
  "section": [
    {
      "title": "Anamnez",
      "code": { "coding": [ { "system": "http://loinc.org", "code": "10164-2" } ] },
      "author": [ { "reference": "PractitionerRole/example-practitionerrole" } ],
      "text": {
        "status": "generated",
        "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Bosh og'rig'i, 3 kundan beri.</div>"
      },
      "orderedBy": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/list-order", "code": "event-date" } ] },
      "entry": [ { "reference": "Condition/example-headache" } ]
    },
    {
      "title": "Allergiyalar",
      "code": { "coding": [ { "system": "http://loinc.org", "code": "48765-2" } ] },
      "text": {
        "status": "generated",
        "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Ma'lum allergiyalar yo'q.</div>"
      },
      "emptyReason": {
        "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/list-empty-reason", "code": "nilknown" } ]
      }
    }
  ]
}

A section must have at least one of text, entry or nested section, and emptyReason is only allowed when the section has no entries. Section codes are usually LOINC document section codes, here 10164-2 (history of present illness) and 48765-2 (allergies). text.status is generated when the narrative is produced from the entries, additional when it says more than they do. orderedBy tells the reader how the entries are sorted, here by event date. Section author is only needed when it differs from the document author.

For example API calls, see the Quick Start at the bottom of this page.

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description Differentials, Snapshots, and other representations.

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Composition 0..* Composition(5.0.0) A set of resources composed into a single coherent clinical statement with clinical attestation
Composition.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
Composition.contained 0..* Resource Contained, inline Resources
Composition.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored
Constraints: ext-1
Composition.status This element is a modifier element. This element must be supported. This element is included in summaries. 1..1 code registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
Binding: CompositionStatusVS (0.13.0) (required)
Composition.type This element must be supported. This element is included in summaries. 1..1 CodeableConcept Kind of composition (LOINC if possible)
Binding: CompositionTypeVS (0.13.0) (required)
Composition.Slices for category This element must be supported. This element is included in summaries. 0..* CodeableConcept Categorization of Composition
Slice: Unordered, Open by value:$this
Binding: CompositionCategoryVS (0.13.0) (preferred)

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Composition.Slices for category.category:dhpCategory This element must be supported. This element is included in summaries. 0..* CodeableConcept Category from the national value set
Binding: CompositionCategoryVS (0.13.0) (required)
Composition.subject This element must be supported. This element is included in summaries. 0..* Reference(Resource) Who and/or what the medical document or digital form is about.
Composition.date This element must be supported. This element is included in summaries. 1..1 dateTime Composition editing time
Composition.author This element must be supported. This element is included in summaries. 1..* Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0) | UZ Core Device(0.13.0)) Who and/or what authored the composition
Composition.title This element must be supported. This element is included in summaries. 1..1 string Human Readable name/title
Composition.attester This element must be supported. 0..* BackboneElement Attests to accuracy of composition
Composition.attester.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
Composition.attester.mode This element must be supported. 1..1 CodeableConcept personal | professional | legal | official
Binding: CompositionAttModeVS (0.13.0) (preferred)
Composition.attester.party This element must be supported. 0..1 Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) Who attested the composition
Composition.custodian This element must be supported. This element is included in summaries. 0..1 Reference(UZ Core Organization(0.13.0)) Organization which maintains the composition
Composition.section This element must be supported. C 0..* BackboneElement Composition is broken into sections
Constraints: cmp-1, cmp-2
Composition.section.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
Composition.section.title This element must be supported. 0..1 string Label for section (e.g. for ToC)
Composition.section.code This element must be supported. 0..1 CodeableConcept Classification of section (recommended)
Binding: DocumentSectionCodes (example): Classification of a section of a composition/document.
Composition.section.author This element must be supported. 0..* Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) Who and/or what authored the section
Composition.section.text This element must be supported. C 0..1 Narrative Text summary of the section, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Composition.section.text.status This element must be supported. 1..1 code generated | extensions | additional | empty
Binding: CompositionNarrativeStatusVS (0.13.0) (required)
Composition.section.text.div This element must be supported. C 1..1 xhtml Limited xhtml content
Constraints: txt-1, txt-2
Composition.section.orderedBy This element must be supported. 0..1 CodeableConcept Order of section entries
Binding: CompositionListOrderVS (0.13.0) (preferred)
Composition.section.entry This element must be supported. C 0..* Reference(Resource) A reference to data that supports this section
Composition.section.emptyReason This element must be supported. C 0..1 CodeableConcept Why the section is empty
Binding: CompositionListEmptyReasonVS (0.13.0) (required)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Composition.status Base required Composition status 📍0.13.0 This IG
Composition.type Base required Composition type 📍0.13.0 This IG
Composition.category Base preferred Composition category 📍0.13.0 This IG
Composition.category:dhpCategory Base required Composition category 📍0.13.0 This IG
Composition.attester.​mode Base preferred Composition attestation mode 📍0.13.0 This IG
Composition.section.​code Base example Document Section Codes 📍5.0.0 FHIR Std.
Composition.section.​text.status Base required Composition narrative status 📍0.13.0 This IG
Composition.section.​orderedBy Base preferred Composition list order 📍0.13.0 This IG
Composition.section.​emptyReason Base required Composition list empty reason 📍0.13.0 This IG

Constraints

Id Grade Path(s) Description Expression

This structure is derived from Composition

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Composition 0..* Composition(5.0.0) A set of resources composed into a single coherent clinical statement with clinical attestation
Composition.status This element must be supported. 1..1 code registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
Binding: CompositionStatusVS (0.13.0) (required)
Composition.type This element must be supported. 1..1 CodeableConcept Kind of composition (LOINC if possible)
Binding: CompositionTypeVS (0.13.0) (required)
Composition.Slices for category This element must be supported. 0..* CodeableConcept Categorization of Composition
Slice: Unordered, Open by value:$this
Binding: CompositionCategoryVS (0.13.0) (preferred)
Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Composition.Slices for category.category:dhpCategory This element must be supported. 0..* CodeableConcept Category from the national value set
Binding: CompositionCategoryVS (0.13.0) (required)
Composition.date This element must be supported. 1..1 dateTime Composition editing time
Composition.author This element must be supported. 1..* Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0) | UZ Core Device(0.13.0)) Who and/or what authored the composition
Composition.title This element must be supported. 1..1 string Human Readable name/title
Composition.attester This element must be supported. 0..* BackboneElement Attests to accuracy of composition
Composition.attester.mode This element must be supported. 1..1 CodeableConcept personal | professional | legal | official
Binding: CompositionAttModeVS (0.13.0) (preferred)
Composition.attester.party This element must be supported. 0..1 Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) Who attested the composition
Composition.custodian This element must be supported. 0..1 Reference(UZ Core Organization(0.13.0)) Organization which maintains the composition
Composition.section This element must be supported. 0..* BackboneElement Composition is broken into sections
Composition.section.title This element must be supported. 0..1 string Label for section (e.g. for ToC)
Composition.section.code This element must be supported. 0..1 CodeableConcept Classification of section (recommended)
Composition.section.author This element must be supported. 0..* Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) Who and/or what authored the section
Composition.section.text This element must be supported. 0..1 Narrative Text summary of the section, for human interpretation
Composition.section.text.status This element must be supported. 1..1 code generated | extensions | additional | empty
Binding: CompositionNarrativeStatusVS (0.13.0) (required)
Composition.section.text.div This element must be supported. 1..1 xhtml Limited xhtml content
Composition.section.orderedBy This element must be supported. 0..1 CodeableConcept Order of section entries
Binding: CompositionListOrderVS (0.13.0) (preferred)
Composition.section.entry This element must be supported. 0..* Reference(Resource) A reference to data that supports this section
Composition.section.emptyReason This element must be supported. 0..1 CodeableConcept Why the section is empty
Binding: CompositionListEmptyReasonVS (0.13.0) (required)

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Composition.status Base required Composition status 📍0.13.0 This IG
Composition.type Base required Composition type 📍0.13.0 This IG
Composition.category Base preferred Composition category 📍0.13.0 This IG
Composition.category:dhpCategory Base required Composition category 📍0.13.0 This IG
Composition.attester.​mode Base preferred Composition attestation mode 📍0.13.0 This IG
Composition.section.​text.status Base required Composition narrative status 📍0.13.0 This IG
Composition.section.​orderedBy Base preferred Composition list order 📍0.13.0 This IG
Composition.section.​emptyReason Base required Composition list empty reason 📍0.13.0 This IG
NameFlagsCard.TypeDescription & Constraints    Filter: doco
Composition 0..* Composition(5.0.0) A set of resources composed into a single coherent clinical statement with clinical attestation
Composition.id This element is included in summaries. 0..1 id Logical id of this artifact
Composition.meta This element is included in summaries. 0..1 Meta Metadata about the resource
Composition.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
Composition.language 0..1 code Language of the resource content
Binding: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
Composition.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
Composition.contained 0..* Resource Contained, inline Resources
Composition.extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
Composition.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored
Constraints: ext-1
Composition.url This element is included in summaries. 0..1 uri Canonical identifier for this Composition, represented as a URI (globally unique)
Composition.identifier This element is included in summaries. 0..* Identifier Version-independent identifier for the Composition
Composition.version This element is included in summaries. 0..1 string An explicitly assigned identifer of a variation of the content in the Composition
Composition.status This element is a modifier element. This element must be supported. This element is included in summaries. 1..1 code registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
Binding: CompositionStatusVS (0.13.0) (required)
Composition.type This element must be supported. This element is included in summaries. 1..1 CodeableConcept Kind of composition (LOINC if possible)
Binding: CompositionTypeVS (0.13.0) (required)
Composition.Slices for category This element must be supported. This element is included in summaries. 0..* CodeableConcept Categorization of Composition
Slice: Unordered, Open by value:$this
Binding: CompositionCategoryVS (0.13.0) (preferred)

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Composition.Slices for category.category:dhpCategory This element must be supported. This element is included in summaries. 0..* CodeableConcept Category from the national value set
Binding: CompositionCategoryVS (0.13.0) (required)
Composition.subject This element must be supported. This element is included in summaries. 0..* Reference(Resource) Who and/or what the medical document or digital form is about.
Composition.encounter This element is included in summaries. 0..1 Reference(Encounter) Context of the Composition
Composition.date This element must be supported. This element is included in summaries. 1..1 dateTime Composition editing time
Composition.useContext This element is included in summaries. 0..* UsageContext The context that the content is intended to support
Composition.author This element must be supported. This element is included in summaries. 1..* Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0) | UZ Core Device(0.13.0)) Who and/or what authored the composition
Composition.name This element is included in summaries. 0..1 string Name for this Composition (computer friendly)
Composition.title This element must be supported. This element is included in summaries. 1..1 string Human Readable name/title
Composition.note 0..* Annotation For any additional notes
Composition.attester This element must be supported. 0..* BackboneElement Attests to accuracy of composition
Composition.attester.id 0..1 string Unique id for inter-element referencing
Composition.attester.extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
Composition.attester.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
Composition.attester.mode This element must be supported. 1..1 CodeableConcept personal | professional | legal | official
Binding: CompositionAttModeVS (0.13.0) (preferred)
Composition.attester.time 0..1 dateTime When the composition was attested
Composition.attester.party This element must be supported. 0..1 Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) Who attested the composition
Composition.custodian This element must be supported. This element is included in summaries. 0..1 Reference(UZ Core Organization(0.13.0)) Organization which maintains the composition
Composition.relatesTo 0..* RelatedArtifact Relationships to other compositions/documents
Composition.event This element is included in summaries. 0..* BackboneElement The clinical service(s) being documented
Composition.event.id 0..1 string Unique id for inter-element referencing
Composition.event.extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
Composition.event.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
Composition.event.period This element is included in summaries. 0..1 Period The period covered by the documentation
Composition.event.detail This element is included in summaries. 0..* CodeableReference(Resource) The event(s) being documented, as code(s), reference(s), or both
Binding: ActCode (3.0.0) (example): This list of codes represents the main clinical acts being documented.
Composition.section This element must be supported. C 0..* BackboneElement Composition is broken into sections
Constraints: cmp-1, cmp-2
Composition.section.id 0..1 string Unique id for inter-element referencing
Composition.section.extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
Composition.section.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
Composition.section.title This element must be supported. 0..1 string Label for section (e.g. for ToC)
Composition.section.code This element must be supported. 0..1 CodeableConcept Classification of section (recommended)
Binding: DocumentSectionCodes (example): Classification of a section of a composition/document.
Composition.section.author This element must be supported. 0..* Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) Who and/or what authored the section
Composition.section.focus 0..1 Reference(Resource) Who/what the section is about, when it is not about the subject of composition
Composition.section.text This element must be supported. C 0..1 Narrative Text summary of the section, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Composition.section.text.id 0..1 id Unique id for inter-element referencing
Composition.section.text.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
Constraints: ext-1
Composition.section.text.status This element must be supported. 1..1 code generated | extensions | additional | empty
Binding: CompositionNarrativeStatusVS (0.13.0) (required)
Composition.section.text.div This element must be supported. C 1..1 xhtml Limited xhtml content
Constraints: txt-1, txt-2
Composition.section.orderedBy This element must be supported. 0..1 CodeableConcept Order of section entries
Binding: CompositionListOrderVS (0.13.0) (preferred)
Composition.section.entry This element must be supported. C 0..* Reference(Resource) A reference to data that supports this section
Composition.section.emptyReason This element must be supported. C 0..1 CodeableConcept Why the section is empty
Binding: CompositionListEmptyReasonVS (0.13.0) (required)
Composition.section.section 0..* See section (Composition) Nested Section

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Composition.language Base required All Languages 📍5.0.0 FHIR Std.
Composition.status Base required Composition status 📍0.13.0 This IG
Composition.type Base required Composition type 📍0.13.0 This IG
Composition.category Base preferred Composition category 📍0.13.0 This IG
Composition.category:dhpCategory Base required Composition category 📍0.13.0 This IG
Composition.attester.​mode Base preferred Composition attestation mode 📍0.13.0 This IG
Composition.event.detail Base example v3 Code System ActCode 📍3.0.0 THO v7.5
Composition.section.​code Base example Document Section Codes 📍5.0.0 FHIR Std.
Composition.section.​text.status Base required Composition narrative status 📍0.13.0 This IG
Composition.section.​orderedBy Base preferred Composition list order 📍0.13.0 This IG
Composition.section.​emptyReason Base required Composition list empty reason 📍0.13.0 This IG

Constraints

Id Grade Path(s) Description Expression

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Composition 0..* Composition(5.0.0) A set of resources composed into a single coherent clinical statement with clinical attestation
Composition.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
Composition.contained 0..* Resource Contained, inline Resources
Composition.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored
Constraints: ext-1
Composition.status This element is a modifier element. This element must be supported. This element is included in summaries. 1..1 code registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
Binding: CompositionStatusVS (0.13.0) (required)
Composition.type This element must be supported. This element is included in summaries. 1..1 CodeableConcept Kind of composition (LOINC if possible)
Binding: CompositionTypeVS (0.13.0) (required)
Composition.Slices for category This element must be supported. This element is included in summaries. 0..* CodeableConcept Categorization of Composition
Slice: Unordered, Open by value:$this
Binding: CompositionCategoryVS (0.13.0) (preferred)

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Composition.Slices for category.category:dhpCategory This element must be supported. This element is included in summaries. 0..* CodeableConcept Category from the national value set
Binding: CompositionCategoryVS (0.13.0) (required)
Composition.subject This element must be supported. This element is included in summaries. 0..* Reference(Resource) Who and/or what the medical document or digital form is about.
Composition.date This element must be supported. This element is included in summaries. 1..1 dateTime Composition editing time
Composition.author This element must be supported. This element is included in summaries. 1..* Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0) | UZ Core Device(0.13.0)) Who and/or what authored the composition
Composition.title This element must be supported. This element is included in summaries. 1..1 string Human Readable name/title
Composition.attester This element must be supported. 0..* BackboneElement Attests to accuracy of composition
Composition.attester.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
Composition.attester.mode This element must be supported. 1..1 CodeableConcept personal | professional | legal | official
Binding: CompositionAttModeVS (0.13.0) (preferred)
Composition.attester.party This element must be supported. 0..1 Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) Who attested the composition
Composition.custodian This element must be supported. This element is included in summaries. 0..1 Reference(UZ Core Organization(0.13.0)) Organization which maintains the composition
Composition.section This element must be supported. C 0..* BackboneElement Composition is broken into sections
Constraints: cmp-1, cmp-2
Composition.section.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
Composition.section.title This element must be supported. 0..1 string Label for section (e.g. for ToC)
Composition.section.code This element must be supported. 0..1 CodeableConcept Classification of section (recommended)
Binding: DocumentSectionCodes (example): Classification of a section of a composition/document.
Composition.section.author This element must be supported. 0..* Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) Who and/or what authored the section
Composition.section.text This element must be supported. C 0..1 Narrative Text summary of the section, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Composition.section.text.status This element must be supported. 1..1 code generated | extensions | additional | empty
Binding: CompositionNarrativeStatusVS (0.13.0) (required)
Composition.section.text.div This element must be supported. C 1..1 xhtml Limited xhtml content
Constraints: txt-1, txt-2
Composition.section.orderedBy This element must be supported. 0..1 CodeableConcept Order of section entries
Binding: CompositionListOrderVS (0.13.0) (preferred)
Composition.section.entry This element must be supported. C 0..* Reference(Resource) A reference to data that supports this section
Composition.section.emptyReason This element must be supported. C 0..1 CodeableConcept Why the section is empty
Binding: CompositionListEmptyReasonVS (0.13.0) (required)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Composition.status Base required Composition status 📍0.13.0 This IG
Composition.type Base required Composition type 📍0.13.0 This IG
Composition.category Base preferred Composition category 📍0.13.0 This IG
Composition.category:dhpCategory Base required Composition category 📍0.13.0 This IG
Composition.attester.​mode Base preferred Composition attestation mode 📍0.13.0 This IG
Composition.section.​code Base example Document Section Codes 📍5.0.0 FHIR Std.
Composition.section.​text.status Base required Composition narrative status 📍0.13.0 This IG
Composition.section.​orderedBy Base preferred Composition list order 📍0.13.0 This IG
Composition.section.​emptyReason Base required Composition list empty reason 📍0.13.0 This IG

Constraints

Id Grade Path(s) Description Expression

Differential View

This structure is derived from Composition

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Composition 0..* Composition(5.0.0) A set of resources composed into a single coherent clinical statement with clinical attestation
Composition.status This element must be supported. 1..1 code registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
Binding: CompositionStatusVS (0.13.0) (required)
Composition.type This element must be supported. 1..1 CodeableConcept Kind of composition (LOINC if possible)
Binding: CompositionTypeVS (0.13.0) (required)
Composition.Slices for category This element must be supported. 0..* CodeableConcept Categorization of Composition
Slice: Unordered, Open by value:$this
Binding: CompositionCategoryVS (0.13.0) (preferred)
Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Composition.Slices for category.category:dhpCategory This element must be supported. 0..* CodeableConcept Category from the national value set
Binding: CompositionCategoryVS (0.13.0) (required)
Composition.subject This element must be supported. 0..* Reference(Resource) Who and/or what the medical document or digital form is about.
Composition.date This element must be supported. 1..1 dateTime Composition editing time
Composition.author This element must be supported. 1..* Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0) | UZ Core Device(0.13.0)) Who and/or what authored the composition
Composition.title This element must be supported. 1..1 string Human Readable name/title
Composition.attester This element must be supported. 0..* BackboneElement Attests to accuracy of composition
Composition.attester.mode This element must be supported. 1..1 CodeableConcept personal | professional | legal | official
Binding: CompositionAttModeVS (0.13.0) (preferred)
Composition.attester.party This element must be supported. 0..1 Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) Who attested the composition
Composition.custodian This element must be supported. 0..1 Reference(UZ Core Organization(0.13.0)) Organization which maintains the composition
Composition.section This element must be supported. 0..* BackboneElement Composition is broken into sections
Composition.section.title This element must be supported. 0..1 string Label for section (e.g. for ToC)
Composition.section.code This element must be supported. 0..1 CodeableConcept Classification of section (recommended)
Composition.section.author This element must be supported. 0..* Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) Who and/or what authored the section
Composition.section.text This element must be supported. 0..1 Narrative Text summary of the section, for human interpretation
Composition.section.text.status This element must be supported. 1..1 code generated | extensions | additional | empty
Binding: CompositionNarrativeStatusVS (0.13.0) (required)
Composition.section.text.div This element must be supported. 1..1 xhtml Limited xhtml content
Composition.section.orderedBy This element must be supported. 0..1 CodeableConcept Order of section entries
Binding: CompositionListOrderVS (0.13.0) (preferred)
Composition.section.entry This element must be supported. 0..* Reference(Resource) A reference to data that supports this section
Composition.section.emptyReason This element must be supported. 0..1 CodeableConcept Why the section is empty
Binding: CompositionListEmptyReasonVS (0.13.0) (required)

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Composition.status Base required Composition status 📍0.13.0 This IG
Composition.type Base required Composition type 📍0.13.0 This IG
Composition.category Base preferred Composition category 📍0.13.0 This IG
Composition.category:dhpCategory Base required Composition category 📍0.13.0 This IG
Composition.attester.​mode Base preferred Composition attestation mode 📍0.13.0 This IG
Composition.section.​text.status Base required Composition narrative status 📍0.13.0 This IG
Composition.section.​orderedBy Base preferred Composition list order 📍0.13.0 This IG
Composition.section.​emptyReason Base required Composition list empty reason 📍0.13.0 This IG

Snapshot ViewView

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Composition 0..* Composition(5.0.0) A set of resources composed into a single coherent clinical statement with clinical attestation
Composition.id This element is included in summaries. 0..1 id Logical id of this artifact
Composition.meta This element is included in summaries. 0..1 Meta Metadata about the resource
Composition.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
Composition.language 0..1 code Language of the resource content
Binding: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
Composition.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
Composition.contained 0..* Resource Contained, inline Resources
Composition.extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
Composition.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored
Constraints: ext-1
Composition.url This element is included in summaries. 0..1 uri Canonical identifier for this Composition, represented as a URI (globally unique)
Composition.identifier This element is included in summaries. 0..* Identifier Version-independent identifier for the Composition
Composition.version This element is included in summaries. 0..1 string An explicitly assigned identifer of a variation of the content in the Composition
Composition.status This element is a modifier element. This element must be supported. This element is included in summaries. 1..1 code registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
Binding: CompositionStatusVS (0.13.0) (required)
Composition.type This element must be supported. This element is included in summaries. 1..1 CodeableConcept Kind of composition (LOINC if possible)
Binding: CompositionTypeVS (0.13.0) (required)
Composition.Slices for category This element must be supported. This element is included in summaries. 0..* CodeableConcept Categorization of Composition
Slice: Unordered, Open by value:$this
Binding: CompositionCategoryVS (0.13.0) (preferred)

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Composition.Slices for category.category:dhpCategory This element must be supported. This element is included in summaries. 0..* CodeableConcept Category from the national value set
Binding: CompositionCategoryVS (0.13.0) (required)
Composition.subject This element must be supported. This element is included in summaries. 0..* Reference(Resource) Who and/or what the medical document or digital form is about.
Composition.encounter This element is included in summaries. 0..1 Reference(Encounter) Context of the Composition
Composition.date This element must be supported. This element is included in summaries. 1..1 dateTime Composition editing time
Composition.useContext This element is included in summaries. 0..* UsageContext The context that the content is intended to support
Composition.author This element must be supported. This element is included in summaries. 1..* Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0) | UZ Core Device(0.13.0)) Who and/or what authored the composition
Composition.name This element is included in summaries. 0..1 string Name for this Composition (computer friendly)
Composition.title This element must be supported. This element is included in summaries. 1..1 string Human Readable name/title
Composition.note 0..* Annotation For any additional notes
Composition.attester This element must be supported. 0..* BackboneElement Attests to accuracy of composition
Composition.attester.id 0..1 string Unique id for inter-element referencing
Composition.attester.extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
Composition.attester.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
Composition.attester.mode This element must be supported. 1..1 CodeableConcept personal | professional | legal | official
Binding: CompositionAttModeVS (0.13.0) (preferred)
Composition.attester.time 0..1 dateTime When the composition was attested
Composition.attester.party This element must be supported. 0..1 Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) Who attested the composition
Composition.custodian This element must be supported. This element is included in summaries. 0..1 Reference(UZ Core Organization(0.13.0)) Organization which maintains the composition
Composition.relatesTo 0..* RelatedArtifact Relationships to other compositions/documents
Composition.event This element is included in summaries. 0..* BackboneElement The clinical service(s) being documented
Composition.event.id 0..1 string Unique id for inter-element referencing
Composition.event.extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
Composition.event.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
Composition.event.period This element is included in summaries. 0..1 Period The period covered by the documentation
Composition.event.detail This element is included in summaries. 0..* CodeableReference(Resource) The event(s) being documented, as code(s), reference(s), or both
Binding: ActCode (3.0.0) (example): This list of codes represents the main clinical acts being documented.
Composition.section This element must be supported. C 0..* BackboneElement Composition is broken into sections
Constraints: cmp-1, cmp-2
Composition.section.id 0..1 string Unique id for inter-element referencing
Composition.section.extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
Composition.section.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
Composition.section.title This element must be supported. 0..1 string Label for section (e.g. for ToC)
Composition.section.code This element must be supported. 0..1 CodeableConcept Classification of section (recommended)
Binding: DocumentSectionCodes (example): Classification of a section of a composition/document.
Composition.section.author This element must be supported. 0..* Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) Who and/or what authored the section
Composition.section.focus 0..1 Reference(Resource) Who/what the section is about, when it is not about the subject of composition
Composition.section.text This element must be supported. C 0..1 Narrative Text summary of the section, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Composition.section.text.id 0..1 id Unique id for inter-element referencing
Composition.section.text.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
Constraints: ext-1
Composition.section.text.status This element must be supported. 1..1 code generated | extensions | additional | empty
Binding: CompositionNarrativeStatusVS (0.13.0) (required)
Composition.section.text.div This element must be supported. C 1..1 xhtml Limited xhtml content
Constraints: txt-1, txt-2
Composition.section.orderedBy This element must be supported. 0..1 CodeableConcept Order of section entries
Binding: CompositionListOrderVS (0.13.0) (preferred)
Composition.section.entry This element must be supported. C 0..* Reference(Resource) A reference to data that supports this section
Composition.section.emptyReason This element must be supported. C 0..1 CodeableConcept Why the section is empty
Binding: CompositionListEmptyReasonVS (0.13.0) (required)
Composition.section.section 0..* See section (Composition) Nested Section

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Composition.language Base required All Languages 📍5.0.0 FHIR Std.
Composition.status Base required Composition status 📍0.13.0 This IG
Composition.type Base required Composition type 📍0.13.0 This IG
Composition.category Base preferred Composition category 📍0.13.0 This IG
Composition.category:dhpCategory Base required Composition category 📍0.13.0 This IG
Composition.attester.​mode Base preferred Composition attestation mode 📍0.13.0 This IG
Composition.event.detail Base example v3 Code System ActCode 📍3.0.0 THO v7.5
Composition.section.​code Base example Document Section Codes 📍5.0.0 FHIR Std.
Composition.section.​text.status Base required Composition narrative status 📍0.13.0 This IG
Composition.section.​orderedBy Base preferred Composition list order 📍0.13.0 This IG
Composition.section.​emptyReason Base required Composition list empty reason 📍0.13.0 This IG

Constraints

Id Grade Path(s) Description Expression

 

Other representations of profile: CSV, Excel, Schematron

Quick Start

Common API interactions for this profile. Requests require a JWT access token - see Security and authentication. [base] is the FHIR server base URL; | separates a code system from its value and must be URL-encoded as %7C.

Read a composition by server id, and its earlier versions

GET [base]/Composition/[id]
GET [base]/Composition/[id]/_history

Search

GET [base]/Composition?patient=Patient/[id]
GET [base]/Composition?patient=Patient/[id]&type=https://terminology.dhp.uz/fhir/core/CodeSystem/composition-type-cs%7Cemdoc-0010-0003
GET [base]/Composition?patient=Patient/[id]&category=https://terminology.dhp.uz/fhir/core/CodeSystem/composition-category-cs%7CComp-001-0001
GET [base]/Composition?patient=Patient/[id]&status=final&date=ge2026-01-01
GET [base]/Composition?author=PractitionerRole/[id]
GET [base]/Composition?encounter=Encounter/[id]
GET [base]/Composition?entry=Condition/[id]
GET [base]/Composition?section=http://loinc.org%7C48765-2
GET [base]/Composition?patient=Patient/[id]&_include=Composition:entry

The last query returns the compositions together with the resources their sections reference.

Create a composition

POST [base]/Composition
{
  "resourceType": "Composition",
  "meta": { "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-composition" ] },
  "language": "uz",
  "status": "preliminary",
  "type": { "coding": [ { "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/composition-type-cs", "code": "..." } ] },
  "subject": [ { "reference": "Patient/[id]" } ],
  "date": "...",
  "author": [ { "reference": "PractitionerRole/[id]" } ],
  "title": "...",
  "section": [ ... ]
}

Update an existing composition (e.g. set status to final once the document is complete, or to amended after a change)

PUT [base]/Composition/[id]
If-Match: W/"3"   # the ETag from your last read; 412 if it changed since
{
  "resourceType": "Composition",
  "id": "[id]",
  "meta": { "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-composition" ] },
  "status": "final",
  ...
}

Update date with every change. Assembling and signing finalised documents is specified in the DHP Integrations IG.

See the CapabilityStatement for the full list of supported search parameters.