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 element to FHIR.

DatasetUS Core 6.1.0 target profile(s)
goalsUS Core Goal

goals

One row per goal per patient.

ColumnRequiredFormat / valuesExample
patient_identifierYespatient keyMRN-4471903
lifecycle_statusYesproposed, planned, accepted, active, on-hold, completed, cancelled, entered-in-error, rejected goal-statusactive
description_codeYesSNOMED CT code, with description_system; or plain text us-core-goal-description281004
start_dateIf availabledate2026-04-18
target_dateIf availabledate2026-10-18
  • description_code is the one field with no fallback: a row without it cannot become a Goal. Send a SNOMED CT code with description_system as http://snomed.info/sct; the binding is extensible over a value set that spans essentially all of SNOMED CT. 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: