Goal resource (FHIR R4)

Goal is the FHIR R4 resource for 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.

Example

{
  "resourceType": "Goal",
  "id": "goal-11501ba341b5803ef1471d80cd9da3e9",
  "lifecycleStatus": "active",
  "category": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/goal-category",
          "code": "dietary"
        }
      ]
    }
  ],
  "priority": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/goal-priority",
        "code": "medium-priority",
        "display": "Medium Priority"
      }
    ]
  },
  "description": {
    "text": "Reduce dietary sodium below 2,300 mg per day"
  },
  "subject": {
    "reference": "Patient/patient-L46A6EIB9J"
  },
  "startDate": "2026-07-01",
  "target": [
    {
      "dueDate": "2026-10-19"
    }
  ]
}

Generated by the Pidgeon engine: pidgeon generate Goal --seed 20260722.

Validation context

• strict pidgeon validate grades a Goal instance against the base R4 structure definition: missing required elements raise REQUIRED_FIELD_MISSING and cardinality violations raise CARDINALITY_MIN or CARDINALITY_MAX.(REQUIRED_FIELD_MISSING)
• strict Profile validation grades the same instance against an installed IG profile: profile cardinality findings carry FHIR-PROFILE-CARDINALITY and terminology binding findings carry FHIR-PROFILE-BINDING.(FHIR-PROFILE-CARDINALITY)