Skip to content

CarePlan resource (FHIR R4)

CarePlan is the FHIR R4 resource for describes the intention of how one or more practitioners intend to deliver care for a particular patient, group or community for a period of time, possibly limited to care for a specific condition or set of conditions.

ResourceCarePlan
FHIR versionR4 (4.0.1)
Canonical URLhttp://hl7.org/fhir/StructureDefinition/CarePlan
Required elementsstatus (1..1), intent (1..1), subject (1..1)
IG profiles in this catalog1

Example

{
  "resourceType": "CarePlan",
  "id": "careplan-f6a1517d7d43b145a1b895d060ab8eda",
  "status": "active",
  "intent": "plan",
  "title": "Post-Surgical Recovery Plan",
  "subject": {
    "reference": "Patient/patient-L46A6EIB9J"
  },
  "period": {
    "start": "2026-07-01",
    "end": "2027-01-01"
  },
  "category": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "omitted",
          "display": "SNOMED CT code omitted from this published example"
        }
      ]
    }
  ],
  "activity": [
    {
      "detail": {
        "status": "not-started",
        "description": "Follow-up appointment in 2 weeks"
      }
    },
    {
      "detail": {
        "status": "not-started",
        "description": "Lab work before next visit"
      }
    }
  ]
}

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

Validation context

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

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.