> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metriport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CarePlan

> 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.

## Properties

| Name                     | Required | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Description                                                                                                                          |
| ------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| identifier               | No       | [Identifier](/medical-api/fhir/data-types/identifier)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | External Ids for this plan                                                                                                           |
| instantiatesCanonical    | No       | canonical\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Instantiates FHIR protocol or definition                                                                                             |
| instantiatesUri          | No       | uri\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Instantiates external protocol or definition                                                                                         |
| basedOn                  | No       | Reference\<[CarePlan](/medical-api/fhir/resources/careplan)>\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Fulfills CarePlan                                                                                                                    |
| replaces                 | No       | Reference\<[CarePlan](/medical-api/fhir/resources/careplan)>\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | CarePlan replaced by this CarePlan                                                                                                   |
| partOf                   | No       | Reference\<[CarePlan](/medical-api/fhir/resources/careplan)>\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Part of referenced CarePlan                                                                                                          |
| status                   | Yes      | code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | draft / active / on-hold / revoked / completed / entered-in-error / unknown                                                          |
| intent                   | Yes      | code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | proposal / plan / order / option                                                                                                     |
| category                 | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Type of plan                                                                                                                         |
| title                    | No       | string                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Human-friendly name for the care plan                                                                                                |
| description              | No       | string                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Summary of nature of plan                                                                                                            |
| subject                  | Yes      | Reference\<[Patient](/medical-api/fhir/resources/patient) / [Group](/medical-api/fhir/resources/group)>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Who the care plan is for                                                                                                             |
| encounter                | No       | Reference\<[Encounter](/medical-api/fhir/resources/encounter)>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Encounter created as part of                                                                                                         |
| period                   | No       | [Period](/medical-api/fhir/data-types/period)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Time period plan covers                                                                                                              |
| created                  | No       | dateTime                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Date record was first recorded                                                                                                       |
| author                   | No       | Reference\<[Patient](/medical-api/fhir/resources/patient) / [Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole) / [Device](/medical-api/fhir/resources/device) / [RelatedPerson](/medical-api/fhir/resources/relatedperson) / [Organization](/medical-api/fhir/resources/organization) / [CareTeam](/medical-api/fhir/resources/careteam)>                                                                                                                                                                         | Who is the designated responsible party                                                                                              |
| contributor              | No       | Reference\<[Patient](/medical-api/fhir/resources/patient) / [Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole) / [Device](/medical-api/fhir/resources/device) / [RelatedPerson](/medical-api/fhir/resources/relatedperson) / [Organization](/medical-api/fhir/resources/organization) / [CareTeam](/medical-api/fhir/resources/careteam)>\[]                                                                                                                                                                      | Who provided the content of the care plan                                                                                            |
| careTeam                 | No       | Reference\<[CareTeam](/medical-api/fhir/resources/careteam)>\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Who's involved in plan?                                                                                                              |
| addresses                | No       | Reference\<[Condition](/medical-api/fhir/resources/condition)>\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Health issues this plan addresses                                                                                                    |
| supportingInfo           | No       | Reference\<Resource>\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Information considered as part of plan                                                                                               |
| goal                     | No       | Reference\<[Goal](/medical-api/fhir/resources/goal)>\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Desired outcome of plan                                                                                                              |
| activity                 | No       | CarePlanActivity                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Action to occur as part of plan                                                                                                      |
| - id                     | No       | string                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Unique id for inter-element referencing                                                                                              |
| - extension              | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Additional content defined by implementations                                                                                        |
| - modifierExtension      | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Extensions that cannot be ignored even if unrecognized                                                                               |
| - outcomeCodeableConcept | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Results of the activity                                                                                                              |
| - outcomeReference       | No       | Reference\<Resource>\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Appointment, Encounter, Procedure, etc.                                                                                              |
| - progress               | No       | [Annotation](/medical-api/fhir/data-types/annotation)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Comments about the activity status/progress                                                                                          |
| - reference              | No       | Reference\<[Appointment](/medical-api/fhir/resources/appointment) / [CommunicationRequest](/medical-api/fhir/resources/communicationrequest) / [DeviceRequest](/medical-api/fhir/resources/devicerequest) / [MedicationRequest](/medical-api/fhir/resources/medicationrequest) / [NutritionOrder](/medical-api/fhir/resources/nutritionorder) / [Task](/medical-api/fhir/resources/task) / [ServiceRequest](/medical-api/fhir/resources/servicerequest) / [VisionPrescription](/medical-api/fhir/resources/visionprescription) / [RequestGroup](/medical-api/fhir/resources/requestgroup)> | Activity details defined in specific resource                                                                                        |
| - detail                 | No       | CarePlanActivityDetail                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | In-line definition of activity                                                                                                       |
| - id                     | No       | string                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Unique id for inter-element referencing                                                                                              |
| - extension              | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Additional content defined by implementations                                                                                        |
| - modifierExtension      | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Extensions that cannot be ignored even if unrecognized                                                                               |
| - kind                   | No       | code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Appointment / CommunicationRequest / DeviceRequest / MedicationRequest / NutritionOrder / Task / ServiceRequest / VisionPrescription |
| - instantiatesCanonical  | No       | canonical\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Instantiates FHIR protocol or definition                                                                                             |
| - instantiatesUri        | No       | uri\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Instantiates external protocol or definition                                                                                         |
| - code                   | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Detail type of activity                                                                                                              |
| - reasonCode             | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Why activity should be done or why activity was prohibited                                                                           |
| - reasonReference        | No       | Reference\<[Condition](/medical-api/fhir/resources/condition) / [Observation](/medical-api/fhir/resources/observation) / [DiagnosticReport](/medical-api/fhir/resources/diagnosticreport) / [DocumentReference](/medical-api/fhir/resources/documentreference)>\[]                                                                                                                                                                                                                                                                                                                         | Why activity is needed                                                                                                               |
| - goal                   | No       | Reference\<[Goal](/medical-api/fhir/resources/goal)>\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Goals this activity relates to                                                                                                       |
| - status                 | Yes      | code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | not-started / scheduled / in-progress / on-hold / completed / cancelled / stopped / unknown / entered-in-error                       |
| - statusReason           | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Reason for current status                                                                                                            |
| - doNotPerform           | No       | boolean                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | If true, activity is prohibiting action                                                                                              |
| - scheduled\[x]          | No       | [Timing](/medical-api/fhir/data-types/timing), [Period](/medical-api/fhir/data-types/period), string                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | When activity is to occur                                                                                                            |
| - location               | No       | Reference\<[Location](/medical-api/fhir/resources/location)>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Where it should happen                                                                                                               |
| - performer              | No       | Reference\<[Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole) / [Organization](/medical-api/fhir/resources/organization) / [RelatedPerson](/medical-api/fhir/resources/relatedperson) / [Patient](/medical-api/fhir/resources/patient) / [CareTeam](/medical-api/fhir/resources/careteam) / [HealthcareService](/medical-api/fhir/resources/healthcareservice) / [Device](/medical-api/fhir/resources/device)>\[]                                                                                                 | Who will be responsible?                                                                                                             |
| - product\[x]            | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept), Reference\<[Medication](/medical-api/fhir/resources/medication) / [Substance](/medical-api/fhir/resources/substance)>                                                                                                                                                                                                                                                                                                                                                                                                     | What is to be administered/supplied                                                                                                  |
| - dailyAmount            | No       | [Quantity](/medical-api/fhir/data-types/quantity)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | How to consume/day?                                                                                                                  |
| - quantity               | No       | [Quantity](/medical-api/fhir/data-types/quantity)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | How much to administer/supply/consume                                                                                                |
| - description            | No       | string                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Extra info describing activity to perform                                                                                            |
| note                     | No       | [Annotation](/medical-api/fhir/data-types/annotation)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Comments about the plan                                                                                                              |

## Search Parameters

| Name                   | Type      | Description                                                                                                                                                                             | Expression                         |
| ---------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| date                   | date      | Time period plan covers                                                                                                                                                                 | CarePlan.period                    |
| identifier             | token     | External Ids for this plan                                                                                                                                                              | CarePlan.identifier                |
| patient                | reference | Who the care plan is for                                                                                                                                                                | CarePlan.subject                   |
| activity-code          | token     | Detail type of activity                                                                                                                                                                 | CarePlan.activity.detail.code      |
| activity-date          | date      | Specified date occurs within period specified by CarePlan.activity.detail.scheduled\[x]                                                                                                 | CarePlan.activity.detail.scheduled |
| activity-reference     | reference | Activity details defined in specific resource                                                                                                                                           | CarePlan.activity.reference        |
| based-on               | reference | Fulfills CarePlan                                                                                                                                                                       | CarePlan.basedOn                   |
| care-team              | reference | Who's involved in plan?                                                                                                                                                                 | CarePlan.careTeam                  |
| category               | token     | Type of plan                                                                                                                                                                            | CarePlan.category                  |
| condition              | reference | Health issues this plan addresses                                                                                                                                                       | CarePlan.addresses                 |
| encounter              | reference | Encounter created as part of                                                                                                                                                            | CarePlan.encounter                 |
| goal                   | reference | Desired outcome of plan                                                                                                                                                                 | CarePlan.goal                      |
| instantiates-canonical | reference | Instantiates FHIR protocol or definition                                                                                                                                                | CarePlan.instantiatesCanonical     |
| instantiates-uri       | uri       | Instantiates external protocol or definition                                                                                                                                            | CarePlan.instantiatesUri           |
| intent                 | token     | proposal / plan / order / option                                                                                                                                                        | CarePlan.intent                    |
| part-of                | reference | Part of referenced CarePlan                                                                                                                                                             | CarePlan.partOf                    |
| performer              | reference | Matches if the practitioner is listed as a performer in any of the "simple" activities. (For performers of the detailed activities, chain through the activitydetail search parameter.) | CarePlan.activity.detail.performer |
| replaces               | reference | CarePlan replaced by this CarePlan                                                                                                                                                      | CarePlan.replaces                  |
| status                 | token     | draft / active / on-hold / revoked / completed / entered-in-error / unknown                                                                                                             | CarePlan.status                    |
| subject                | reference | Who the care plan is for                                                                                                                                                                | CarePlan.subject                   |

## Inherited Properties

| Name              | Required | Type                                                   | Description                                            |
| ----------------- | -------- | ------------------------------------------------------ | ------------------------------------------------------ |
| id                | No       | string                                                 | Logical id of this artifact                            |
| meta              | No       | [Meta](/medical-api/fhir/data-types/meta)              | Metadata about the resource                            |
| implicitRules     | No       | uri                                                    | A set of rules under which this content was created    |
| language          | No       | code                                                   | Language of the resource content                       |
| text              | No       | [Narrative](/medical-api/fhir/data-types/narrative)    | Text summary of the resource, for human interpretation |
| contained         | No       | Resource\[]                                            | Contained, inline Resources                            |
| extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations          |
| modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored                      |

To view the FHIR specification for this resource, see [CarePlan](https://www.hl7.org/fhir/StructureDefinition/CarePlan).
