Goal - FHIR Resource (stu3)
This Goal Resource uses the FHIR API standard for access and structure.
Validate an Goal FHIR Resource (stu3)
Goal Attributes
AttributeField is listTypeDescription
Description: proposed | accepted | planned | in-progress | on-target | ahead-of-target | behind-target | sustaining | achieved | on-hold | cancelled | entered-in-error | rejected
FHIR Version: stu3
Attribute Type : code
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"status": "on-hold"Learn more about the (Goal) status FHIR attribute
Description: E.g. Treatment, dietary, behavioral, etc.
FHIR Version: stu3
Attribute Type : CodeableConcept
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"category": [
{
"coding": [
{
"code": "dietary",
"system": "http://hl7.org/fhir/goal-category"
}
]
}
]Learn more about the (Goal) category FHIR attribute
Description: Observation that resulted from goal
FHIR Version: stu3
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"outcomeReference": [
{
"display": "Body Weight Measured",
"reference": "Observation/example"
}
]Learn more about the (Goal) outcomeReference FHIR attribute
Description: "addresses" : [{ Reference(Condition|Observation|MedicationStatement|
FHIR Version: stu3
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"addresses": [
{
"display": "obesity condition"
}
]Learn more about the (Goal) addresses FHIR attribute
Description: "startDate" : "<date>",
FHIR Version: stu3
Attribute Type : date
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"startDate": "2015-04-05"Learn more about the (Goal) startDate FHIR attribute
Description: Who this goal is intended for
FHIR Version: stu3
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"subject": {
"display": "Peter James Chalmers",
"reference": "Patient/example"
}Learn more about the (Goal) subject FHIR attribute
Description: "startCodeableConcept" : { CodeableConcept },
FHIR Version: stu3
Attribute Type : CodeableConcept
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"startCodeableConcept": Learn more about the (Goal) startCodeableConcept FHIR attribute
Description: Reason for current status
FHIR Version: stu3
Attribute Type : string
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"statusReason": "Patient wants to defer weight loss until after honeymoon."Learn more about the (Goal) statusReason FHIR attribute
Description: Comments about the goal
FHIR Version: stu3
Attribute Type : Annotation
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"note": Learn more about the (Goal) note FHIR attribute
Description: What result was achieved regarding the goal?
FHIR Version: stu3
Attribute Type : CodeableConcept
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"outcomeCode": Learn more about the (Goal) outcomeCode FHIR attribute
Description: Who's responsible for creating Goal?
FHIR Version: stu3
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"expressedBy": {
"display": "Peter James Chalmers",
"reference": "Patient/example"
}Learn more about the (Goal) expressedBy FHIR attribute
Description: When goal status took effect
FHIR Version: stu3
Attribute Type : date
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"statusDate": "2016-02-14"Learn more about the (Goal) statusDate FHIR attribute
Description: high-priority | medium-priority | low-priority
FHIR Version: stu3
Attribute Type : CodeableConcept
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"priority": {
"text": "high",
"coding": [
{
"code": "high-priority",
"system": "http://hl7.org/fhir/goal-priority",
"display": "High Priority"
}
]
}Learn more about the (Goal) priority FHIR attribute
Description: External Ids for this goal
FHIR Version: stu3
Attribute Type : Identifier
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"identifier": [
{
"value": "123"
}
]Learn more about the (Goal) identifier FHIR attribute
Description: C? Target outcome for the goal
FHIR Version: stu3
Attribute Type : Data Type
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"target": {
"detailRange": {
"high": {
"code": "[lb_av]",
"unit": "lbs",
"value": 180,
"system": "http://unitsofmeasure.org"
},
"low": {
"code": "[lb_av]",
"unit": "lbs",
"value": 160,
"system": "http://unitsofmeasure.org"
}
},
"dueDate": "2016-04-05",
"measure": {
"coding": [
{
"code": "3141-9",
"system": "http://loinc.org",
"display": "Weight Measured"
}
]
}
}Learn more about the (Goal) target FHIR attribute
Description: Code or text describing goal
FHIR Version: stu3
Attribute Type : CodeableConcept
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"description": {
"text": "Target weight is 160 to 180 lbs."
}Learn more about the (Goal) description FHIR attribute
Goal Example
{
"status": "on-hold",
"category": [
{
"coding": [
{
"code": "dietary",
"system": "http://hl7.org/fhir/goal-category"
}
]
}
],
"outcomeReference": [
{
"display": "Body Weight Measured",
"reference": "Observation/example"
}
],
"addresses": [
{
"display": "obesity condition"
}
],
"description": {
"text": "Target weight is 160 to 180 lbs."
},
"startDate": "2015-04-05",
"resourceType": "Goal",
"text": {
"status": "additional",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n\t\t\t<p> A simple care goal for a patient to lose weight due to obesity.</p>\n\t\t</div>"
},
"expressedBy": {
"display": "Peter James Chalmers",
"reference": "Patient/example"
},
"statusReason": "Patient wants to defer weight loss until after honeymoon.",
"priority": {
"text": "high",
"coding": [
{
"code": "high-priority",
"system": "http://hl7.org/fhir/goal-priority",
"display": "High Priority"
}
]
},
"target": {
"detailRange": {
"high": {
"code": "[lb_av]",
"unit": "lbs",
"value": 180,
"system": "http://unitsofmeasure.org"
},
"low": {
"code": "[lb_av]",
"unit": "lbs",
"value": 160,
"system": "http://unitsofmeasure.org"
}
},
"dueDate": "2016-04-05",
"measure": {
"coding": [
{
"code": "3141-9",
"system": "http://loinc.org",
"display": "Weight Measured"
}
]
}
},
"statusDate": "2016-02-14",
"identifier": [
{
"value": "123"
}
],
"id": "example",
"subject": {
"display": "Peter James Chalmers",
"reference": "Patient/example"
}
}Goal Structure
{
"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 | accepted | planned | in-progress | on-target | ahead-of-target | behind-target | sustaining | achieved | on-hold | cancelled | entered-in-error | rejected
"category" : [{ CodeableConcept }], // E.g. Treatment, dietary, behavioral, etc.
"priority" : { CodeableConcept }, // high-priority | medium-priority | low-priority
"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" : { // C? Target outcome for the goal
"measure" : { CodeableConcept }, // C? The parameter whose value is being tracked
// detail[x]: The target value to be achieved. One of these 3:
"detailQuantity" : { Quantity },
"detailRange" : { Range },
"detailCodeableConcept" : { CodeableConcept },
// due[x]: Reach goal on or before. One of these 2:
"dueDate" : "<date>"
"dueDuration" : { Duration }
},
"statusDate" : "<date>", // When goal status took effect
"statusReason" : "<string>", // Reason for current status
"expressedBy" : { Reference(Patient|Practitioner|RelatedPerson) }, // Who's responsible for creating Goal?
"addresses" : [{ Reference(Condition|Observation|MedicationStatement|
NutritionOrder|ProcedureRequest|RiskAssessment) }], // Issues addressed by this goal
"note" : [{ Annotation }], // Comments about the goal
"outcomeCode" : [{ CodeableConcept }], // What result was achieved regarding the goal?
"outcomeReference" : [{ Reference(Observation) }] // Observation that resulted from goal
}
Goal Search Parameters
The following search parameters can be used to query Goal resources. Just submit them like so:
https://api.1up.health/fhir/stu3/Goal?query-param=queryvalue| Search Parameter | Field Type | Resource Fields Searched |
|---|---|---|
category | text | category |
identifier | text | identifier |
patient | reference | subject |
start-date | date | start.as |
status | text | status |
subject | reference | subject |
target-date | date | target.due.as |
