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

# Goal

> Describes the intended objective(s) for a patient, group or organization care, for example, weight loss, restoring an activity of daily living, obtaining herd immunity via immunization, meeting a process improvement objective, etc.

## Properties

| Name                | Required | Type                                                                                                                                                                                                                                                                                                                                                                                             | Description                                                                                                           |
| ------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| identifier          | No       | [Identifier](/medical-api/fhir/data-types/identifier)\[]                                                                                                                                                                                                                                                                                                                                         | External Ids for this goal                                                                                            |
| lifecycleStatus     | Yes      | code                                                                                                                                                                                                                                                                                                                                                                                             | proposed / planned / accepted / active / on-hold / completed / cancelled / entered-in-error / rejected                |
| achievementStatus   | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                  | in-progress / improving / worsening / no-change / achieved / sustaining / not-achieved / no-progress / not-attainable |
| category            | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                               | E.g. Treatment, dietary, behavioral, etc.                                                                             |
| priority            | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                  | high-priority / medium-priority / low-priority                                                                        |
| description         | Yes      | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                  | Code or text describing goal                                                                                          |
| subject             | Yes      | Reference\<[Patient](/medical-api/fhir/resources/patient) / [Group](/medical-api/fhir/resources/group) / [Organization](/medical-api/fhir/resources/organization)>                                                                                                                                                                                                                               | Who this goal is intended for                                                                                         |
| start\[x]           | No       | date, [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                            | When goal pursuit begins                                                                                              |
| target              | No       | GoalTarget                                                                                                                                                                                                                                                                                                                                                                                       | Target outcome for the goal                                                                                           |
| - 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                                                                |
| - measure           | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                  | The parameter whose value is being tracked                                                                            |
| - detail\[x]        | No       | [Quantity](/medical-api/fhir/data-types/quantity), [Range](/medical-api/fhir/data-types/range), [CodeableConcept](/medical-api/fhir/data-types/codeableconcept), string, boolean, integer, [Ratio](/medical-api/fhir/data-types/ratio)                                                                                                                                                           | The target value to be achieved                                                                                       |
| - due\[x]           | No       | date, [Duration](/medical-api/fhir/data-types/duration)                                                                                                                                                                                                                                                                                                                                          | Reach goal on or before                                                                                               |
| statusDate          | No       | date                                                                                                                                                                                                                                                                                                                                                                                             | When goal status took effect                                                                                          |
| statusReason        | No       | string                                                                                                                                                                                                                                                                                                                                                                                           | Reason for current status                                                                                             |
| expressedBy         | No       | Reference\<[Patient](/medical-api/fhir/resources/patient) / [Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole) / [RelatedPerson](/medical-api/fhir/resources/relatedperson)>                                                                                                                                            | Who's responsible for creating Goal?                                                                                  |
| addresses           | No       | Reference\<[Condition](/medical-api/fhir/resources/condition) / [Observation](/medical-api/fhir/resources/observation) / [MedicationStatement](/medical-api/fhir/resources/medicationstatement) / [NutritionOrder](/medical-api/fhir/resources/nutritionorder) / [ServiceRequest](/medical-api/fhir/resources/servicerequest) / [RiskAssessment](/medical-api/fhir/resources/riskassessment)>\[] | Issues addressed by this goal                                                                                         |
| note                | No       | [Annotation](/medical-api/fhir/data-types/annotation)\[]                                                                                                                                                                                                                                                                                                                                         | Comments about the goal                                                                                               |
| outcomeCode         | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                               | What result was achieved regarding the goal?                                                                          |
| outcomeReference    | No       | Reference\<[Observation](/medical-api/fhir/resources/observation)>\[]                                                                                                                                                                                                                                                                                                                            | Observation that resulted from goal                                                                                   |

## Search Parameters

| Name               | Type      | Description                                                                                                           | Expression             |
| ------------------ | --------- | --------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| identifier         | token     | External Ids for this goal                                                                                            | Goal.identifier        |
| patient            | reference | Who this goal is intended for                                                                                         | Goal.subject           |
| achievement-status | token     | in-progress / improving / worsening / no-change / achieved / sustaining / not-achieved / no-progress / not-attainable | Goal.achievementStatus |
| category           | token     | E.g. Treatment, dietary, behavioral, etc.                                                                             | Goal.category          |
| lifecycle-status   | token     | proposed / planned / accepted / active / on-hold / completed / cancelled / entered-in-error / rejected                | Goal.lifecycleStatus   |
| start-date         | date      | When goal pursuit begins                                                                                              | Goal.start             |
| subject            | reference | Who this goal is intended for                                                                                         | Goal.subject           |
| target-date        | date      | Reach goal on or before                                                                                               | Goal.target.due        |

## 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 [Goal](https://www.hl7.org/fhir/StructureDefinition/Goal).