haau3 FHIR Implementation Guide (HFIG)
1.0.0 - ci-build United States of America flag

haau3 FHIR Implementation Guide (HFIG) - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: haau3 Goal

Official URL: https://haau3.com/fhir/StructureDefinition/haau3-goal Version: 1.0.0
Draft as of 2026-10-14 Computable Name: Haau3Goal

A goal recorded about a care recipient, delivered as the source system stated it. The goal itself is commonly carried in the description's text rather than a code, and haau3 delivers both exactly as they arrived.

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Goal 0..* USCoreGoalProfile(6.1.0) Describes the intended objective(s) for a patient, group or organization
Goal.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
Goal.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Goal.identifier This element must be supported. 1..* Identifier External Ids for this goal
Goal.lifecycleStatus This element is a modifier element. This element must be supported. This element is included in summaries. 1..1 code (USCDI) proposed | planned | accepted | active | on-hold | completed | cancelled | entered-in-error | rejected
Binding: GoalLifecycleStatus (required)
Goal.description This element must be supported. This element is included in summaries. 1..1 CodeableConcept (USCDI) Code or text describing goal
Binding: US Core Goal Codes (extensible): Value set to describe the Goal
Goal.subject This element must be supported. This element is included in summaries. 1..1 Reference(US Core Patient Profile) (USCDI) Who this goal is intended for
Goal.start[x] This element must be supported. This element is included in summaries. 0..1 (USCDI) When goal pursuit begins
Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal.
Goal.start[x].startDate date This target must be supported.
Goal.start[x].startCodeableConcept CodeableConcept
Goal.target This element must be supported. C 0..* BackboneElement (USCDI) Target outcome for the goal
Constraints: gol-1
Goal.target.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Goal.target.due[x] This element must be supported. This element is included in summaries. 0..1 (USCDI) Reach goal on or before
Goal.target.due[x].dueDate date This target must be supported.
Goal.target.due[x].dueDuration Duration

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Goal.lifecycleStatus Base required GoalLifecycleStatus 📦4.0.1 FHIR Std.
Goal.description Base extensible US Core Goal Codes 📦6.1.0 US Core v6.1
Goal.start[x] Base example Goal start event 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Goal If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Goal If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Goal If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Goal If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Goal A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
gol-1 error Goal.target Goal.target.measure is required if Goal.target.detail is populated (detail.exists() and measure.exists()) or detail.exists().not()

This structure is derived from USCoreGoalProfile

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Goal 0..* USCoreGoalProfile(6.1.0) Describes the intended objective(s) for a patient, group or organization
Goal.identifier This element must be supported. 1..* Identifier External Ids for this goal

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: doco
Goal 0..* USCoreGoalProfile(6.1.0) Describes the intended objective(s) for a patient, group or organization
Goal.id This element is included in summaries. 0..1 id Logical id of this artifact
Goal.meta This element is included in summaries. 0..1 Meta Metadata about the resource
Goal.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
Goal.language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages Max Binding
Goal.text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Goal.contained 0..* Resource Contained, inline Resources
Goal.extension 0..* Extension Additional content defined by implementations
Goal.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Goal.identifier This element must be supported. 1..* Identifier External Ids for this goal
Goal.lifecycleStatus This element is a modifier element. This element must be supported. This element is included in summaries. 1..1 code (USCDI) proposed | planned | accepted | active | on-hold | completed | cancelled | entered-in-error | rejected
Binding: GoalLifecycleStatus (required)
Goal.achievementStatus This element is included in summaries. 0..1 CodeableConcept in-progress | improving | worsening | no-change | achieved | sustaining | not-achieved | no-progress | not-attainable
Binding: GoalAchievementStatus (preferred): Indicates the progression, or lack thereof, towards the goal against the target.
Goal.category This element is included in summaries. 0..* CodeableConcept E.g. Treatment, dietary, behavioral, etc.
Binding: GoalCategory (example): Codes for grouping and sorting goals.
Goal.priority This element is included in summaries. 0..1 CodeableConcept high-priority | medium-priority | low-priority
Binding: GoalPriority (preferred): The level of importance associated with a goal.
Goal.description This element must be supported. This element is included in summaries. 1..1 CodeableConcept (USCDI) Code or text describing goal
Binding: US Core Goal Codes (extensible): Value set to describe the Goal
Goal.subject This element must be supported. This element is included in summaries. 1..1 Reference(US Core Patient Profile) (USCDI) Who this goal is intended for
Goal.start[x] This element must be supported. This element is included in summaries. 0..1 (USCDI) When goal pursuit begins
Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal.
Goal.start[x].startDate date This target must be supported.
Goal.start[x].startCodeableConcept CodeableConcept
Goal.target This element must be supported. C 0..* BackboneElement (USCDI) Target outcome for the goal
Constraints: gol-1
Goal.target.id 0..1 string Unique id for inter-element referencing
Goal.target.extension 0..* Extension Additional content defined by implementations
Goal.target.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Goal.target.measure This element is included in summaries. C 0..1 CodeableConcept The parameter whose value is being tracked
Binding: LOINCCodes (example): Codes to identify the value being tracked, e.g. body weight, blood pressure, or hemoglobin A1c level.
Goal.target.detail[x] This element is included in summaries. C 0..1 The target value to be achieved
Binding Description: (example): Codes to identify the target value of the focus to be achieved to signify the fulfillment of the goal.
Goal.target.detail[x].detailQuantity Quantity
Goal.target.detail[x].detailRange Range
Goal.target.detail[x].detailCodeableConcept CodeableConcept
Goal.target.detail[x].detailString string
Goal.target.detail[x].detailBoolean boolean
Goal.target.detail[x].detailInteger integer
Goal.target.detail[x].detailRatio Ratio
Goal.target.due[x] This element must be supported. This element is included in summaries. 0..1 (USCDI) Reach goal on or before
Goal.target.due[x].dueDate date This target must be supported.
Goal.target.due[x].dueDuration Duration
Goal.statusDate This element is included in summaries. 0..1 date When goal status took effect
Goal.statusReason 0..1 string Reason for current status
Goal.expressedBy This element is included in summaries. 0..1 Reference(Patient | Practitioner | PractitionerRole | RelatedPerson) Who's responsible for creating Goal?
Goal.addresses 0..* Reference(Condition | Observation | MedicationStatement | NutritionOrder | ServiceRequest | RiskAssessment) Issues addressed by this goal
Goal.note 0..* Annotation Comments about the goal
Goal.outcomeCode 0..* CodeableConcept What result was achieved regarding the goal?
Binding: SNOMEDCTClinicalFindings (example): 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".
Goal.outcomeReference 0..* Reference(Observation) Observation that resulted from goal

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Goal.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Goal.lifecycleStatus Base required GoalLifecycleStatus 📦4.0.1 FHIR Std.
Goal.achievementStatus Base preferred Goal achievement status 📦4.0.1 FHIR Std.
Goal.category Base example Goal category 📦4.0.1 FHIR Std.
Goal.priority Base preferred Goal priority 📦4.0.1 FHIR Std.
Goal.description Base extensible US Core Goal Codes 📦6.1.0 US Core v6.1
Goal.start[x] Base example Goal start event 📦4.0.1 FHIR Std.
Goal.target.measure Base example LOINC Codes 📦4.0.1 FHIR Std.
Goal.target.detail[x] Base example Not State Unknown
Goal.outcomeCode Base example SNOMED CT Clinical Findings 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Goal If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Goal If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Goal If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Goal If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Goal A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
gol-1 error Goal.target Goal.target.measure is required if Goal.target.detail is populated (detail.exists() and measure.exists()) or detail.exists().not()

This structure is derived from USCoreGoalProfile

Summary

Mandatory: 1 element
Must-Support: 1 element

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Goal 0..* USCoreGoalProfile(6.1.0) Describes the intended objective(s) for a patient, group or organization
Goal.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
Goal.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Goal.identifier This element must be supported. 1..* Identifier External Ids for this goal
Goal.lifecycleStatus This element is a modifier element. This element must be supported. This element is included in summaries. 1..1 code (USCDI) proposed | planned | accepted | active | on-hold | completed | cancelled | entered-in-error | rejected
Binding: GoalLifecycleStatus (required)
Goal.description This element must be supported. This element is included in summaries. 1..1 CodeableConcept (USCDI) Code or text describing goal
Binding: US Core Goal Codes (extensible): Value set to describe the Goal
Goal.subject This element must be supported. This element is included in summaries. 1..1 Reference(US Core Patient Profile) (USCDI) Who this goal is intended for
Goal.start[x] This element must be supported. This element is included in summaries. 0..1 (USCDI) When goal pursuit begins
Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal.
Goal.start[x].startDate date This target must be supported.
Goal.start[x].startCodeableConcept CodeableConcept
Goal.target This element must be supported. C 0..* BackboneElement (USCDI) Target outcome for the goal
Constraints: gol-1
Goal.target.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Goal.target.due[x] This element must be supported. This element is included in summaries. 0..1 (USCDI) Reach goal on or before
Goal.target.due[x].dueDate date This target must be supported.
Goal.target.due[x].dueDuration Duration

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Goal.lifecycleStatus Base required GoalLifecycleStatus 📦4.0.1 FHIR Std.
Goal.description Base extensible US Core Goal Codes 📦6.1.0 US Core v6.1
Goal.start[x] Base example Goal start event 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Goal If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Goal If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Goal If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Goal If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Goal A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
gol-1 error Goal.target Goal.target.measure is required if Goal.target.detail is populated (detail.exists() and measure.exists()) or detail.exists().not()

Differential View

This structure is derived from USCoreGoalProfile

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Goal 0..* USCoreGoalProfile(6.1.0) Describes the intended objective(s) for a patient, group or organization
Goal.identifier This element must be supported. 1..* Identifier External Ids for this goal

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Goal 0..* USCoreGoalProfile(6.1.0) Describes the intended objective(s) for a patient, group or organization
Goal.id This element is included in summaries. 0..1 id Logical id of this artifact
Goal.meta This element is included in summaries. 0..1 Meta Metadata about the resource
Goal.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
Goal.language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages Max Binding
Goal.text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Goal.contained 0..* Resource Contained, inline Resources
Goal.extension 0..* Extension Additional content defined by implementations
Goal.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Goal.identifier This element must be supported. 1..* Identifier External Ids for this goal
Goal.lifecycleStatus This element is a modifier element. This element must be supported. This element is included in summaries. 1..1 code (USCDI) proposed | planned | accepted | active | on-hold | completed | cancelled | entered-in-error | rejected
Binding: GoalLifecycleStatus (required)
Goal.achievementStatus This element is included in summaries. 0..1 CodeableConcept in-progress | improving | worsening | no-change | achieved | sustaining | not-achieved | no-progress | not-attainable
Binding: GoalAchievementStatus (preferred): Indicates the progression, or lack thereof, towards the goal against the target.
Goal.category This element is included in summaries. 0..* CodeableConcept E.g. Treatment, dietary, behavioral, etc.
Binding: GoalCategory (example): Codes for grouping and sorting goals.
Goal.priority This element is included in summaries. 0..1 CodeableConcept high-priority | medium-priority | low-priority
Binding: GoalPriority (preferred): The level of importance associated with a goal.
Goal.description This element must be supported. This element is included in summaries. 1..1 CodeableConcept (USCDI) Code or text describing goal
Binding: US Core Goal Codes (extensible): Value set to describe the Goal
Goal.subject This element must be supported. This element is included in summaries. 1..1 Reference(US Core Patient Profile) (USCDI) Who this goal is intended for
Goal.start[x] This element must be supported. This element is included in summaries. 0..1 (USCDI) When goal pursuit begins
Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal.
Goal.start[x].startDate date This target must be supported.
Goal.start[x].startCodeableConcept CodeableConcept
Goal.target This element must be supported. C 0..* BackboneElement (USCDI) Target outcome for the goal
Constraints: gol-1
Goal.target.id 0..1 string Unique id for inter-element referencing
Goal.target.extension 0..* Extension Additional content defined by implementations
Goal.target.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Goal.target.measure This element is included in summaries. C 0..1 CodeableConcept The parameter whose value is being tracked
Binding: LOINCCodes (example): Codes to identify the value being tracked, e.g. body weight, blood pressure, or hemoglobin A1c level.
Goal.target.detail[x] This element is included in summaries. C 0..1 The target value to be achieved
Binding Description: (example): Codes to identify the target value of the focus to be achieved to signify the fulfillment of the goal.
Goal.target.detail[x].detailQuantity Quantity
Goal.target.detail[x].detailRange Range
Goal.target.detail[x].detailCodeableConcept CodeableConcept
Goal.target.detail[x].detailString string
Goal.target.detail[x].detailBoolean boolean
Goal.target.detail[x].detailInteger integer
Goal.target.detail[x].detailRatio Ratio
Goal.target.due[x] This element must be supported. This element is included in summaries. 0..1 (USCDI) Reach goal on or before
Goal.target.due[x].dueDate date This target must be supported.
Goal.target.due[x].dueDuration Duration
Goal.statusDate This element is included in summaries. 0..1 date When goal status took effect
Goal.statusReason 0..1 string Reason for current status
Goal.expressedBy This element is included in summaries. 0..1 Reference(Patient | Practitioner | PractitionerRole | RelatedPerson) Who's responsible for creating Goal?
Goal.addresses 0..* Reference(Condition | Observation | MedicationStatement | NutritionOrder | ServiceRequest | RiskAssessment) Issues addressed by this goal
Goal.note 0..* Annotation Comments about the goal
Goal.outcomeCode 0..* CodeableConcept What result was achieved regarding the goal?
Binding: SNOMEDCTClinicalFindings (example): 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".
Goal.outcomeReference 0..* Reference(Observation) Observation that resulted from goal

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Goal.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Goal.lifecycleStatus Base required GoalLifecycleStatus 📦4.0.1 FHIR Std.
Goal.achievementStatus Base preferred Goal achievement status 📦4.0.1 FHIR Std.
Goal.category Base example Goal category 📦4.0.1 FHIR Std.
Goal.priority Base preferred Goal priority 📦4.0.1 FHIR Std.
Goal.description Base extensible US Core Goal Codes 📦6.1.0 US Core v6.1
Goal.start[x] Base example Goal start event 📦4.0.1 FHIR Std.
Goal.target.measure Base example LOINC Codes 📦4.0.1 FHIR Std.
Goal.target.detail[x] Base example Not State Unknown
Goal.outcomeCode Base example SNOMED CT Clinical Findings 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Goal If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Goal If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Goal If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Goal If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Goal A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
gol-1 error Goal.target Goal.target.measure is required if Goal.target.detail is populated (detail.exists() and measure.exists()) or detail.exists().not()

This structure is derived from USCoreGoalProfile

Summary

Mandatory: 1 element
Must-Support: 1 element

 

Other representations of profile: CSV, Excel, Schematron