Skip to content

Encounter resource (FHIR R4)

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

ResourceEncounter
FHIR versionR4 (4.0.1)
Canonical URLhttp://hl7.org/fhir/StructureDefinition/Encounter
Required elementsstatus (1..1), class (1..1)
IG profiles in this catalog3

Example

{
  "resourceType": "Encounter",
  "id": "encounter-b445223ffd17941d28eab5f340311f31",
  "status": "finished",
  "class": {
    "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
    "code": "IMP",
    "display": "inpatient encounter"
  },
  "subject": {
    "reference": "Patient/patient-41ZZVTBE9O"
  },
  "participant": [
    {
      "type": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
              "code": "ATND",
              "display": "attender"
            }
          ]
        }
      ],
      "individual": {
        "reference": "Practitioner/practitioner-1827951260",
        "display": "York, Maurice"
      }
    }
  ],
  "period": {
    "start": "2026-06-15T00:00:00Z"
  },
  "location": [
    {
      "location": {
        "display": "Community Health Center"
      },
      "status": "active"
    }
  ]
}

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

Validation context

  • strict pidgeon validate grades a Encounter 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 Encounter

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.