Skip to main content

Goal

Overview​

The Goal resource describes intended objectives for a patient, group, or organization. Goals are used in care planning to establish targets for patient care and track progress toward achieving desired outcomes.

Resource Schema​

Key fields in the Goal resource:

{
  "resourceType": "Goal",
  "id": "example-goal-123",
  "lifecycleStatus": "active",
  "category": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/goal-category",
          "code": "behavioral",
          "display": "Behavioral"
        }
      ]
    }
  ],
  "description": {
    "text": "Patient will lose 10 pounds in 6 months"
  },
  "subject": {
    "reference": "Patient/123456"
  },
  "startDate": "2023-07-15",
  "target": [
    {
      "measure": {
        "coding": [
          {
            "system": "http://loinc.org",
            "code": "29463-7",
            "display": "Body weight"
          }
        ]
      },
      "detailQuantity": {
        "value": 10,
        "unit": "lb",
        "system": "http://unitsofmeasure.org"
      },
      "dueDate": "2024-01-15"
    }
  ]
}

Operations​

The Goal resource supports Read and Search operations. Support varies by CareRecord solution.

CareRecord / SolutionReadSearch
GEHRIMED✅✅
myAvatar✅✅
myEvolv✅✅
myUnity✅✅
TheraOffice✅✅

Read​

HTTP Method: GET
URL: /Goal/{id}

curl -X GET https://fhir.netsmartcloud.com/uscore/v1/Goal/123456 \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

HTTP Method: GET or POST
URL: /Goal or /Goal/_search

Search by Patient
curl -X POST https://fhir.netsmartcloud.com/uscore/v1/Goal/_search \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json" \
    -H "Content-Type: application/x-form-urlencoded" \
    -d "patient=Patient/123"

Integration Patterns​

Common Workflows​

  1. Care Planning - Establish treatment goals and objectives
  2. Progress Tracking - Monitor patient progress toward goals
  3. Outcome Measurement - Evaluate achievement of care objectives

Relationships to Other Resources​

Error Handling​

For common errors and troubleshooting guidance, see Common Errors.

Supported Profiles​