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

Clinical Tests

Datasets

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

clinical_observations

One row per observation. This dataset carries every USCDI observation that is not a lab result, a vital sign or a social history row: non-lab test results, imaging findings, functional, disability and cognitive status, and SDOH screening answers.

ColumnRequiredFormat / valuesExample
patient_identifierYespatient keyMRN-4471903
categoryYesone of the categories belowsdoh
statusYesregistered, preliminary, final, amended, corrected, cancelled, entered-in-error, unknown observation-statusfinal
loinc_codeYesLOINC, with loinc_system76504-0
value_quantityIf numericdecimal3
unitWith value_quantityUCUM{score}
value_stringIf free texttext
value_codeIf codedSNOMED CT or LOINC code, with value_system
data_absent_reasonIf there is no resultunknown, asked-declined, not-performed data-absent-reason
effective_datetimeRecommendeddatetime2026-04-18
performer_npiIf available10 digits1407006835
panel_idIf availableclinical_observations key of the parent rowCO-1200
  • Send exactly one of value_quantity, value_string, value_code or data_absent_reason. A row with a result and an absent reason contradicts itself; a row with neither cannot become an Observation.
  • data_absent_reason is how a screening question that was asked but not answered stays in the record. Leaving the row out instead loses the fact that it was asked.
  • panel_id builds a panel: the member rows point at the parent row's key, and Payerbox links them as panel members. Only the screening-assessment categories support it, which is the case that needs it: a questionnaire whose answers belong to one instrument.

Categories

category selects the profile, and each profile binds it differently.

CategoryBecomesUse it for
examClinical Resulta physical exam finding
imagingClinical Resultan imaging result observation, not the report
procedureClinical Resulta result produced by a procedure
therapyClinical Resulta therapy-related result
activityClinical Resultan activity measure
sdohScreening Assessmenta social-determinants screening answer
functional-statusScreening Assessmenta functional status assessment
disability-statusScreening Assessmenta disability status assessment
cognitive-statusScreening Assessmenta cognitive status assessment
surveySimple Observationa survey answer that is none of the above

Payerbox adds the survey category to every screening assessment, so send only the specific one.

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

Last updated: