For AI agents: the documentation index is at /docs/payerbox/llms.txt. A Markdown version of this page is available at /docs/payerbox/data-integration/uscdi/goals.md or by requesting it with the Accept: text/markdown header.
Payerbox Docs

Goals

Datasets

US Core 6.1.0 maps each USCDI data element onto a FHIR element.

DatasetUS Core 6.1.0 target profile(s)
goalsUS Core Goal

goals

One row per goal per patient.

ColumnRequiredFormat / valuesExample
record_idYesyour stable key for this goalGL-0001
patient_identifierYespatient keyMRN-4471903
lifecycle_statusYesproposed, planned, accepted, active, on-hold, completed, cancelled, entered-in-error, rejected goal-statusactive
description_codeYesSNOMED CT or LOINC code, with description_system; or plain text us-core-goal-description289169006 exercising to lose weight
start_dateIf availabledate2026-04-18
target_dateIf availabledate2026-10-18
is_deletedIf retractingtrue retracts this rowtrue
  • description_code is the one field with no fallback: a row without it cannot become a Goal. Send a SNOMED CT code (description_system = http://snomed.info/sct) or a LOINC code (description_system = http://loinc.org); the binding's own value set spans essentially all of SNOMED CT, and LOINC comes in through its extensibility. A source that records goals only as narrative may put the text itself in description_code and leave description_system empty.
  • lifecycle_status marks each row: active for a goal being pursued, completed/cancelled/rejected for closed ones, entered-in-error to retract a record that should never have existed.
  • target_date is the USCDI "Goal Target Date". US Core requires supporting at least one of Goal.startDate and Goal.target.dueDate, so send whichever your source tracks — either or both are fine.

These resources are served by Patient Access, Provider Access, Payer-to-Payer, and Prior Auth.

Last updated: