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

Problems

Datasets

US Core 6.1.0 maps each USCDI element to FHIR.

conditions

One file covers all four USCDI condition flavours — problems, health concerns, encounter diagnoses, and SDOH — one row per condition per patient; the category column tells them apart.

ColumnRequiredFormat / valuesExample
patient_identifierYespatient keyMRN-4471903
categoryYesone of seven values — see Categoriesproblem-list-item
codeYesSNOMED CT or ICD-10-CM code, with code_system us-core-condition-code44054006 Type 2 diabetes mellitus
clinical_statusRecommendedactive, recurrence, relapse, inactive, remission, resolved condition-clinicalactive
verification_statusRecommendedunconfirmed, provisional, differential, confirmed, refuted, entered-in-error condition-ver-statusconfirmed
onset_dateRecommendeddatetime2021-08-14
abatement_dateIf resolveddatetime2023-11-30
recorded_dateRecommendeddatetime2021-08-15
asserted_dateIf availabledatetime2021-08-15
encounter_idIf encounter-diagnosisencounter keyENC-9912
  • code is the one coded field with no fallback: a row without it cannot become a Condition. The value set spans SNOMED CT, ICD-10-CM, and ICD-9-CM, so send problems and health concerns as SNOMED CT (code_system = http://snomed.info/sct) and claims-sourced encounter diagnoses as ICD-10-CM (code_system = http://hl7.org/fhir/sid/icd-10-cm) — no crosswalk needed. ICD-9-CM (http://hl7.org/fhir/sid/icd-9-cm) exists in the value set for historical records only.
  • clinical_status and verification_status are coupled: FHIR requires clinical_status on every problem-list-item row whose verification_status is not entered-in-error, and forbids it on any row that is entered-in-error. Sending active on live rows and resolved or inactive on closed ones satisfies this.
  • A row with an abatement_date must carry a clinical_status of inactive, resolved, or remission — FHIR rejects an abated condition still marked active.
  • The three onset-side dates differ: onset_date is when the condition clinically began (USCDI Date of Diagnosis), asserted_date is when a practitioner first asserted it, and recorded_date is when the record entered the system. abatement_date is the Date of Resolution. Send whichever your source distinguishes — a source with one condition date puts it in onset_date.
  • encounter_id belongs on encounter-diagnosis rows and must match a row in the encounters dataset.

Categories

category says what kind of condition the row is, and that decides which US Core profile it becomes. encounter-diagnosis rows become Encounter Diagnosis resources; every other value becomes a Problems and Health Concerns resource. The four screening values also add their code to the resource as a second category, so the origin of the finding stays visible.

categoryRow isFHIR it becomesBinding
problem-list-iteman item managed over time on the problem listProblems and Health Concernsus-core-problem-or-health-concern
health-concerna concern not on the formal problem listProblems and Health Concernsus-core-problem-or-health-concern
encounter-diagnosisa diagnosis made during a visitEncounter Diagnosis, tied to the encounter via encounter_idcondition-category, fixed by the profile
sdohsocial-determinants screening findinghealth concern + sdoh screening categoryus-core-screening-assessment-condition-category
functional-statusfunctional-status screening findinghealth concern + functional-status screening categoryus-core-screening-assessment-condition-category
disability-statusdisability screening findinghealth concern + disability-status screening categoryus-core-screening-assessment-condition-category
cognitive-statuscognitive screening findinghealth concern + cognitive-status screening categoryus-core-screening-assessment-condition-category

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

Last updated: