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

Vital Signs

Datasets

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

DatasetUS Core 6.1.0 target profile(s)
vital_signsUS Core Vital Signs, US Core Blood Pressure

vital_signs

One row per measurement, except blood pressure: systolic and diastolic are two components of a single reading, so they share a row.

ColumnRequiredFormat / valuesExample
patient_identifierYespatient keyMRN-4471903
statusYesregistered, preliminary, final, amended, corrected, cancelled, entered-in-error, unknown observation-statusfinal
loinc_codeYesone of the vital sign codes below US Core Vital Signs8867-4
effective_datetimeYesdatetime2026-04-18T09:05:00-04:00
valueUnless blood pressuredecimal72
unitWith valueUCUM/min
component_systolicBlood pressure onlydecimal128
component_diastolicBlood pressure onlydecimal82
encounter_idIf applicableencounters keyENC-9912
performer_npiIf available10 digits1407006835
  • effective_datetime is required here, unlike every other observation in the feed. A vital sign without a time is not a conformant reading.
  • A quantitative vital needs both value and unit, and the unit must be UCUM. /min for heart and respiratory rate, cm for height, kg for weight, Cel for temperature, % for oxygen saturation, kg/m2 for BMI.
  • Blood pressure is the exception: leave value and unit empty and send component_systolic and component_diastolic on the same row with loinc_code 85354-9. Both components are required, so a row with only one is rejected.
  • Payerbox sets the vital-signs category on every row.

Vital sign codes

LOINCMeasurementUnit
85354-9Blood pressure panelcomponents, no unit
8480-6Systolic blood pressuremm[Hg]
8462-4Diastolic blood pressuremm[Hg]
8867-4Heart rate/min
9279-1Respiratory rate/min
8310-5Body temperatureCel
8302-2Body heightcm
29463-7Body weightkg
39156-5Body mass indexkg/m2
59408-5Oxygen saturation by pulse oximetry%
9843-4Head circumferencecm
8289-1Head circumference percentile%
59576-9Body mass index percentile%
77606-2Weight for length percentile%

The last four are the paediatric percentiles. The binding also accepts 2708-6, 3150-0 and 3151-8 for oxygen measures, 8478-0 for mean blood pressure, and 85353-1 for the full vital signs panel.

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

Last updated: