Skip to content

Composition resource (FHIR R4)

Composition is the FHIR R4 resource for 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.

ResourceComposition
FHIR versionR4 (4.0.1)
Canonical URLhttp://hl7.org/fhir/StructureDefinition/Composition
Required elementsstatus (1..1), type (1..1), date (1..1), author (1..*), title (1..1)

Example

{
  "resourceType": "Composition",
  "id": "composition-d5ae9cf3e5433c30da23d1cdbf43e614",
  "status": "preliminary",
  "type": {
    "text": "Synthetic value"
  },
  "date": "2026-07-01T12:00:00Z",
  "author": [
    {
      "reference": "Practitioner/practitioner-d02ac3fdd5c97346a37eca2c2d4ebad3"
    }
  ],
  "title": "Synthetic value"
}

Generated by the Pidgeon engine: pidgeon generate Composition --seed 20260722.

Validation context

  • strict pidgeon validate grades a Composition instance against the base R4 structure definition: missing required elements raise REQUIRED_FIELD_MISSING and cardinality violations raise CARDINALITY_MIN or CARDINALITY_MAX.(REQUIRED_FIELD_MISSING)

This answer, in your terminal

pidgeon lookup Composition

Wire it into your AI agent:

claude mcp add pidgeon -- npx -y @pidgeonhealth/mcp

Download Post free to browse this reference with generation attached.

FHIR® R4 © Health Level Seven International. FHIR R4 specification content is used under its CC0 license; this page is a derivative work and is not endorsed by HL7 International.

HL7® and FHIR® are registered trademarks of Health Level Seven International.

Published by Pattern Engine LLC (Pidgeon Health).

Rendered from the same machine-readable definitions the Pidgeon engine validates against. Exported from the Pidgeon engine's FHIR R4 definitions (CC0); example generated with seed 20260722.