EpisodeOfCare resource (FHIR R4)

EpisodeOfCare is the FHIR R4 resource for an association between a patient and an organization / healthcare provider(s) during which time encounters may occur.

Resource	EpisodeOfCare
FHIR version	R4 (4.0.1)
Canonical URL	http://hl7.org/fhir/StructureDefinition/EpisodeOfCare
Required elements	status (1..1), patient (1..1)

Example

{
  "resourceType": "EpisodeOfCare",
  "id": "episodeofcare-ab586cd8c0b12dc783f547b9b4e0a734",
  "status": "planned",
  "patient": {
    "reference": "Patient/patient-08567e3dfcff02d35217e77e58f03e5b"
  }
}

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

Validation context

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

Wire it into your AI agent:

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

Download Post free to browse this reference with generation attached.