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/care-plans.md or by requesting it with the Accept: text/markdown header.
Payerbox Docs

Assessment and Plan of Treatment

Datasets

US Core 6.1.0 maps each USCDI element to FHIR.

DatasetUS Core 6.1.0 target profile(s)
care_plansUS Core CarePlan

care_plans

One row per care plan. This dataset carries the Assessment and Plan of Treatment narrative; the SDOH Assessment element of the same class comes from clinical_observations.

ColumnRequiredFormat / valuesExample
patient_identifierYespatient keyMRN-4471903
narrative_textYestext or HTML; the assessment and plan itselfAssessment: … Plan: …
statusYesdraft, active, on-hold, revoked, completed, entered-in-error, unknown request-statusactive
intentYesproposal, plan, order, option care-plan-intentplan
period_startIf availabledatetime2026-04-18
period_endIf availabledatetime
  • narrative_text is the payload of this dataset, not a summary of it. US Core requires the narrative on every CarePlan, so a row without it cannot become one. Send the assessment and the plan as your source holds them; HTML is preserved, plain text is wrapped.
  • Payerbox sets the assess-plan category and the narrative status on every row. Both are fixed by the profile, so there is nothing for you to send.
  • status and intent are required bindings, so a value outside these lists is rejected. A plan a payer holds is normally active with intent plan.

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

Last updated: