This page is part of the FHIR Specification (v1.8.0: STU 3 Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2
Patient Care Work Group | Maturity Level: 1 | Compartments: Patient |
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.
A Goal in health care services delivery is generally an expressed desired health state to be achieved by a subject of care (or family/group) over a period or at a specific point of time. This desired target health state may be achieved as a result of health care intervention(s) or resulting from natural recovery over time. For example:
Goals may address the prevention of illness, cure or mitigation of a condition, prolongation of life, or mitigation of pain and discomfort.
When dealing with groups, goals may also reflect health state, such as a reduction of addiction behaviors. However, they may also reflect population health objectives such as education, screening, etc.
Organizational goals are typically not health state specific but may instead identify measurement targets such as infection control, cost management, patient satisfaction, etc.
Goals are typically established in the context of a CarePlan. However, goals may also be directly referenced by request-type resources (e.g. MedicationRequest or ReferralRequest) by using an extension.
A goal represents a specific goal instance for a particular patient, group, etc. It is not intended to be used to define types of potential goals as part of an order set or protocol definition. Protocol definitions and order sets are supported through PlanDefinition. The Goal resource is intended to be used once an order set is instantiated or assigned to a patient, which is when the potential goals become the actual goals, if not changed or deleted.
Goals are often evaluated using Observations.
This resource is referenced by careplan
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Goal | DomainResource | Describes the intended objective(s) for a patient, group or organization | ||
identifier | 0..* | Identifier | External Ids for this goal | |
status | ?!Σ | 1..1 | code | proposed | planned | accepted | rejected | in-progress | achieved | sustaining | on-hold | cancelled | on-target | ahead-of-target | behind-target | entered-in-error GoalStatus (Required) |
category | Σ | 0..* | CodeableConcept | E.g. Treatment, dietary, behavioral, etc. GoalCategory (Example) |
priority | Σ | 0..1 | CodeableConcept | high | medium |low GoalPriority (Preferred) |
description | Σ | 1..1 | CodeableConcept | Code or text describing goal |
subject | Σ | 0..1 | Reference(Patient | Group | Organization) | Who this goal is intended for |
start[x] | Σ | 0..1 | When goal pursuit begins GoalStartEvent (Example) | |
startDate | date | |||
startCodeableConcept | CodeableConcept | |||
target[x] | Σ | 0..1 | Reach goal on or before | |
targetDate | date | |||
targetDuration | Duration | |||
statusDate | Σ | 0..1 | date | When goal status took effect |
statusReason | 0..* | CodeableConcept | Reason for current status GoalStatusReason (Example) | |
expressedBy | Σ | 0..1 | Reference(Patient | Practitioner | RelatedPerson) | Who's responsible for creating Goal? |
addresses | 0..* | Reference(Condition | Observation | MedicationStatement | NutritionRequest | ProcedureRequest | RiskAssessment) | Issues addressed by this goal | |
note | 0..* | Annotation | Comments about the goal | |
outcome | 0..* | BackboneElement | What result was achieved regarding the goal? | |
result[x] | 0..1 | Code or observation that resulted from goal | ||
resultCodeableConcept | CodeableConcept | |||
resultReference | Reference(Observation) | |||
Documentation for this format |
UML Diagram (Legend)
XML Template
<Goal xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier External Ids for this goal --></identifier> <status value="[code]"/><!-- 1..1 proposed | planned | accepted | rejected | in-progress | achieved | sustaining | on-hold | cancelled | on-target | ahead-of-target | behind-target | entered-in-error --> <category><!-- 0..* CodeableConcept E.g. Treatment, dietary, behavioral, etc. --></category> <priority><!-- 0..1 CodeableConcept high | medium |low --></priority> <description><!-- 1..1 CodeableConcept Code or text describing goal --></description> <subject><!-- 0..1 Reference(Patient|Group|Organization) Who this goal is intended for --></subject> <start[x]><!-- 0..1 date|CodeableConcept When goal pursuit begins --></start[x]> <target[x]><!-- 0..1 date|Duration Reach goal on or before --></target[x]> <statusDate value="[date]"/><!-- 0..1 When goal status took effect --> <statusReason><!-- 0..* CodeableConcept Reason for current status --></statusReason> <expressedBy><!-- 0..1 Reference(Patient|Practitioner|RelatedPerson) Who's responsible for creating Goal? --></expressedBy> <addresses><!-- 0..* Reference(Condition|Observation|MedicationStatement| NutritionRequest|ProcedureRequest|RiskAssessment) Issues addressed by this goal --></addresses> <note><!-- 0..* Annotation Comments about the goal --></note> <outcome> <!-- 0..* What result was achieved regarding the goal? --> <result[x]><!-- 0..1 CodeableConcept|Reference(Observation) Code or observation that resulted from goal --></result[x]> </outcome> </Goal>
JSON Template
{ "resourceType" : "Goal", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : [{ Identifier }], // External Ids for this goal "status" : "<code>", // R! proposed | planned | accepted | rejected | in-progress | achieved | sustaining | on-hold | cancelled | on-target | ahead-of-target | behind-target | entered-in-error "category" : [{ CodeableConcept }], // E.g. Treatment, dietary, behavioral, etc. "priority" : { CodeableConcept }, // high | medium |low "description" : { CodeableConcept }, // R! Code or text describing goal "subject" : { Reference(Patient|Group|Organization) }, // Who this goal is intended for // start[x]: When goal pursuit begins. One of these 2: "startDate" : "<date>", "startCodeableConcept" : { CodeableConcept }, // target[x]: Reach goal on or before. One of these 2: "targetDate" : "<date>", "targetDuration" : { Duration }, "statusDate" : "<date>", // When goal status took effect "statusReason" : [{ CodeableConcept }], // Reason for current status "expressedBy" : { Reference(Patient|Practitioner|RelatedPerson) }, // Who's responsible for creating Goal? "addresses" : [{ Reference(Condition|Observation|MedicationStatement| NutritionRequest|ProcedureRequest|RiskAssessment) }], // Issues addressed by this goal "note" : [{ Annotation }], // Comments about the goal "outcome" : [{ // What result was achieved regarding the goal? // result[x]: Code or observation that resulted from goal. One of these 2: "resultCodeableConcept" : { CodeableConcept } "resultReference" : { Reference(Observation) } }] }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:Goal; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:Goal.identifier [ Identifier ], ... ; # 0..* External Ids for this goal fhir:Goal.status [ code ]; # 1..1 proposed | planned | accepted | rejected | in-progress | achieved | sustaining | on-hold | cancelled | on-target | ahead-of-target | behind-target | entered-in-error fhir:Goal.category [ CodeableConcept ], ... ; # 0..* E.g. Treatment, dietary, behavioral, etc. fhir:Goal.priority [ CodeableConcept ]; # 0..1 high | medium |low fhir:Goal.description [ CodeableConcept ]; # 1..1 Code or text describing goal fhir:Goal.subject [ Reference(Patient|Group|Organization) ]; # 0..1 Who this goal is intended for # Goal.start[x] : 0..1 When goal pursuit begins. One of these 2 fhir:Goal.startDate [ date ] fhir:Goal.startCodeableConcept [ CodeableConcept ] # Goal.target[x] : 0..1 Reach goal on or before. One of these 2 fhir:Goal.targetDate [ date ] fhir:Goal.targetDuration [ Duration ] fhir:Goal.statusDate [ date ]; # 0..1 When goal status took effect fhir:Goal.statusReason [ CodeableConcept ], ... ; # 0..* Reason for current status fhir:Goal.expressedBy [ Reference(Patient|Practitioner|RelatedPerson) ]; # 0..1 Who's responsible for creating Goal? fhir:Goal.addresses [ Reference(Condition|Observation|MedicationStatement|NutritionRequest|ProcedureRequest| RiskAssessment) ], ... ; # 0..* Issues addressed by this goal fhir:Goal.note [ Annotation ], ... ; # 0..* Comments about the goal fhir:Goal.outcome [ # 0..* What result was achieved regarding the goal? # Goal.outcome.result[x] : 0..1 Code or observation that resulted from goal. One of these 2 fhir:Goal.outcome.resultCodeableConcept [ CodeableConcept ] fhir:Goal.outcome.resultReference [ Reference(Observation) ] ], ...; ]
Changes since DSTU2
Goal | |
Goal.description | Type changed from string to CodeableConcept |
Goal.target[x] | Remove Quantity{http://hl7.org/fhir/StructureDefinition/Duration}, Add Duration |
Goal.statusReason | Max Cardinality changed from 1 to * |
Goal.expressedBy | added Element |
Goal.addresses | Remove Reference(NutritionOrder), Add Reference(NutritionRequest) |
Goal.author | deleted |
See the Full Difference for further information
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Goal | DomainResource | Describes the intended objective(s) for a patient, group or organization | ||
identifier | 0..* | Identifier | External Ids for this goal | |
status | ?!Σ | 1..1 | code | proposed | planned | accepted | rejected | in-progress | achieved | sustaining | on-hold | cancelled | on-target | ahead-of-target | behind-target | entered-in-error GoalStatus (Required) |
category | Σ | 0..* | CodeableConcept | E.g. Treatment, dietary, behavioral, etc. GoalCategory (Example) |
priority | Σ | 0..1 | CodeableConcept | high | medium |low GoalPriority (Preferred) |
description | Σ | 1..1 | CodeableConcept | Code or text describing goal |
subject | Σ | 0..1 | Reference(Patient | Group | Organization) | Who this goal is intended for |
start[x] | Σ | 0..1 | When goal pursuit begins GoalStartEvent (Example) | |
startDate | date | |||
startCodeableConcept | CodeableConcept | |||
target[x] | Σ | 0..1 | Reach goal on or before | |
targetDate | date | |||
targetDuration | Duration | |||
statusDate | Σ | 0..1 | date | When goal status took effect |
statusReason | 0..* | CodeableConcept | Reason for current status GoalStatusReason (Example) | |
expressedBy | Σ | 0..1 | Reference(Patient | Practitioner | RelatedPerson) | Who's responsible for creating Goal? |
addresses | 0..* | Reference(Condition | Observation | MedicationStatement | NutritionRequest | ProcedureRequest | RiskAssessment) | Issues addressed by this goal | |
note | 0..* | Annotation | Comments about the goal | |
outcome | 0..* | BackboneElement | What result was achieved regarding the goal? | |
result[x] | 0..1 | Code or observation that resulted from goal | ||
resultCodeableConcept | CodeableConcept | |||
resultReference | Reference(Observation) | |||
Documentation for this format |
XML Template
<Goal xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier External Ids for this goal --></identifier> <status value="[code]"/><!-- 1..1 proposed | planned | accepted | rejected | in-progress | achieved | sustaining | on-hold | cancelled | on-target | ahead-of-target | behind-target | entered-in-error --> <category><!-- 0..* CodeableConcept E.g. Treatment, dietary, behavioral, etc. --></category> <priority><!-- 0..1 CodeableConcept high | medium |low --></priority> <description><!-- 1..1 CodeableConcept Code or text describing goal --></description> <subject><!-- 0..1 Reference(Patient|Group|Organization) Who this goal is intended for --></subject> <start[x]><!-- 0..1 date|CodeableConcept When goal pursuit begins --></start[x]> <target[x]><!-- 0..1 date|Duration Reach goal on or before --></target[x]> <statusDate value="[date]"/><!-- 0..1 When goal status took effect --> <statusReason><!-- 0..* CodeableConcept Reason for current status --></statusReason> <expressedBy><!-- 0..1 Reference(Patient|Practitioner|RelatedPerson) Who's responsible for creating Goal? --></expressedBy> <addresses><!-- 0..* Reference(Condition|Observation|MedicationStatement| NutritionRequest|ProcedureRequest|RiskAssessment) Issues addressed by this goal --></addresses> <note><!-- 0..* Annotation Comments about the goal --></note> <outcome> <!-- 0..* What result was achieved regarding the goal? --> <result[x]><!-- 0..1 CodeableConcept|Reference(Observation) Code or observation that resulted from goal --></result[x]> </outcome> </Goal>
JSON Template
{ "resourceType" : "Goal", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : [{ Identifier }], // External Ids for this goal "status" : "<code>", // R! proposed | planned | accepted | rejected | in-progress | achieved | sustaining | on-hold | cancelled | on-target | ahead-of-target | behind-target | entered-in-error "category" : [{ CodeableConcept }], // E.g. Treatment, dietary, behavioral, etc. "priority" : { CodeableConcept }, // high | medium |low "description" : { CodeableConcept }, // R! Code or text describing goal "subject" : { Reference(Patient|Group|Organization) }, // Who this goal is intended for // start[x]: When goal pursuit begins. One of these 2: "startDate" : "<date>", "startCodeableConcept" : { CodeableConcept }, // target[x]: Reach goal on or before. One of these 2: "targetDate" : "<date>", "targetDuration" : { Duration }, "statusDate" : "<date>", // When goal status took effect "statusReason" : [{ CodeableConcept }], // Reason for current status "expressedBy" : { Reference(Patient|Practitioner|RelatedPerson) }, // Who's responsible for creating Goal? "addresses" : [{ Reference(Condition|Observation|MedicationStatement| NutritionRequest|ProcedureRequest|RiskAssessment) }], // Issues addressed by this goal "note" : [{ Annotation }], // Comments about the goal "outcome" : [{ // What result was achieved regarding the goal? // result[x]: Code or observation that resulted from goal. One of these 2: "resultCodeableConcept" : { CodeableConcept } "resultReference" : { Reference(Observation) } }] }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:Goal; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:Goal.identifier [ Identifier ], ... ; # 0..* External Ids for this goal fhir:Goal.status [ code ]; # 1..1 proposed | planned | accepted | rejected | in-progress | achieved | sustaining | on-hold | cancelled | on-target | ahead-of-target | behind-target | entered-in-error fhir:Goal.category [ CodeableConcept ], ... ; # 0..* E.g. Treatment, dietary, behavioral, etc. fhir:Goal.priority [ CodeableConcept ]; # 0..1 high | medium |low fhir:Goal.description [ CodeableConcept ]; # 1..1 Code or text describing goal fhir:Goal.subject [ Reference(Patient|Group|Organization) ]; # 0..1 Who this goal is intended for # Goal.start[x] : 0..1 When goal pursuit begins. One of these 2 fhir:Goal.startDate [ date ] fhir:Goal.startCodeableConcept [ CodeableConcept ] # Goal.target[x] : 0..1 Reach goal on or before. One of these 2 fhir:Goal.targetDate [ date ] fhir:Goal.targetDuration [ Duration ] fhir:Goal.statusDate [ date ]; # 0..1 When goal status took effect fhir:Goal.statusReason [ CodeableConcept ], ... ; # 0..* Reason for current status fhir:Goal.expressedBy [ Reference(Patient|Practitioner|RelatedPerson) ]; # 0..1 Who's responsible for creating Goal? fhir:Goal.addresses [ Reference(Condition|Observation|MedicationStatement|NutritionRequest|ProcedureRequest| RiskAssessment) ], ... ; # 0..* Issues addressed by this goal fhir:Goal.note [ Annotation ], ... ; # 0..* Comments about the goal fhir:Goal.outcome [ # 0..* What result was achieved regarding the goal? # Goal.outcome.result[x] : 0..1 Code or observation that resulted from goal. One of these 2 fhir:Goal.outcome.resultCodeableConcept [ CodeableConcept ] fhir:Goal.outcome.resultReference [ Reference(Observation) ] ], ...; ]
Changes since DSTU2
Goal | |
Goal.description | Type changed from string to CodeableConcept |
Goal.target[x] | Remove Quantity{http://hl7.org/fhir/StructureDefinition/Duration}, Add Duration |
Goal.statusReason | Max Cardinality changed from 1 to * |
Goal.expressedBy | added Element |
Goal.addresses | Remove Reference(NutritionOrder), Add Reference(NutritionRequest) |
Goal.author | deleted |
See the Full Difference for further information
Alternate definitions: Master Definition (XML, JSON), XML Schema/Schematron (for ) + JSON Schema, ShEx (for Turtle), JSON-LD (for RDF as JSON-LD),
Path | Definition | Type | Reference |
---|---|---|---|
Goal.status | Indicates whether the goal has been met and is still being targeted | Required | GoalStatus |
Goal.category | Codes for grouping and sorting goals | Example | GoalCategory |
Goal.priority | The level of importance associated with a goal | Preferred | GoalPriority |
Goal.description | Codes providing the details of a particular goal. This will generally be system or implementation guide-specific. In many systems, only the text element will be used. | Unknown | No details provided yet |
Goal.start[x] | Codes describing events that can trigger the initiation of a goal | Example | GoalStartEvent |
Goal.statusReason | Codes to identify the reason for a goal's current status | Example | GoalStatusReason |
Goal.outcome.result[x] | The result of the goal; e.g. "25% increase in shoulder mobility", "Anxiety reduced to moderate levels". "15 kg weight loss sustained over 6 months" | Unknown | No details provided yet |
Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
Name | Type | Description | Paths | In Common |
category | token | E.g. Treatment, dietary, behavioral, etc. | Goal.category | |
identifier | token | External Ids for this goal | Goal.identifier | 26 Resources |
patient | reference | Who this goal is intended for | Goal.subject (Patient) | 31 Resources |
status | token | proposed | planned | accepted | rejected | in-progress | achieved | sustaining | on-hold | cancelled | on-target | ahead-of-target | behind-target | entered-in-error | Goal.status | |
subject | reference | Who this goal is intended for | Goal.subject (Group, Organization, Patient) | |
targetdate | date | Reach goal on or before | Goal.targetDate |