Skip to content

Observation resource (FHIR R4)

Observation is a FHIR R4 resource. The Pidgeon engine generates synthetic Observation instances and validates them against the R4 structure definitions.

ResourceObservation
FHIR versionR4 (4.0.1)
Canonical URLhttp://hl7.org/fhir/StructureDefinition/Observation
Required elementsstatus (1..1), code (1..1)
IG profiles in this catalog22

Example

{
  "resourceType": "Observation",
  "id": "observation-453465ba023483c63ad4f5e188cde332",
  "status": "final",
  "category": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/observation-category",
          "code": "laboratory",
          "display": "Laboratory"
        }
      ]
    }
  ],
  "code": {
    "coding": [
      {
        "system": "http://loinc.org",
        "code": "omitted",
        "display": "LOINC code omitted from this published example"
      }
    ]
  },
  "subject": {
    "reference": "Patient/patient-377d2bbe05a73d12f0852131568952b8"
  },
  "effectiveDateTime": "2026-07-01T12:00:00Z",
  "valueQuantity": {
    "value": 8.2,
    "unit": "%",
    "system": "http://unitsofmeasure.org",
    "code": "%"
  },
  "referenceRange": [
    {
      "text": "135-145"
    }
  ]
}

Generated by the Pidgeon engine: pidgeon generate Observation --seed 20260722. Codes from licensed terminologies (LOINC, SNOMED CT, CPT, RxNorm) are omitted from published examples.

Validation context

  • strict pidgeon validate grades a Observation 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)
  • strict Profile validation grades the same instance against an installed IG profile: profile cardinality findings carry FHIR-PROFILE-CARDINALITY and terminology binding findings carry FHIR-PROFILE-BINDING.(FHIR-PROFILE-CARDINALITY)

This answer, in your terminal

pidgeon lookup Observation

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.