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.
| Resource | CarePlan |
|---|---|
| FHIR version | R4 (4.0.1) |
| Canonical URL | http://hl7.org/fhir/StructureDefinition/CarePlan |
| Required elements | status (1..1), intent (1..1), subject (1..1) |
| IG profiles in this catalog | 1 |
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 CarePlanWire it into your AI agent:
claude mcp add pidgeon -- npx -y @pidgeonhealth/mcpDownload Post free to browse this reference with generation attached.