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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.