National indicators column dictionary

Field definitions for the approved national CSV schema in snapshot 2026-10-22-30bf3753, and for the corresponding displayed-view exports. Documentation reviewed October 4, 2026; the acquired files retain their original version and checksums.

Seventeen raw CSV fields; displayed indicator exports omit price_basis
Field Meaning and interpretation
series_id Stable publication identity for a curated concept. The adjustment variant is distinguished by producer_code, rather than changing the concept ID.
producer_code Exact original producer series or table code. Adjusted and unadjusted variants have distinct codes.
geography United States for national files. These values do not supply state, county or metro estimates.
period Producer reference period: YYYY-MM for months, YYYY-Qn for quarters, YYYY-MM-DD for days or week-ending dates. Frequency is retained in JSON series metadata.
value Raw source level in frozen raw CSVs; selected calculated value in displayed-view exports. Blank means unavailable, corresponding to JSON null. Blank is never zero.
units The unit applying to this row, including dollar/reference-year/annual-rate conventions. Growth exports use Percent; differences between rates use Percentage points.
adjustment Original seasonal-adjustment convention of the selected producer series. Use matching conventions at both endpoints and for earnings deflation.
price_basis Price reference basis when relevant, such as chained dollars or current dollars; Not applicable otherwise. Present in raw distribution CSVs, omitted from displayed indicator exports.
transformation Raw level in acquired distribution files. Displayed exports identify Published level, Year-over-year change, Previous-period percentage change, Previous-period absolute change, or Quarterly annualized growth as selected. Quarterly GDP may use the published growth companion; indexing is a separate comparison view.
snapshot Immutable approved site acquisition ID. Distinct from reference period, producer publication date and this documentation's date.
status Preserved source qualifier, for example Published, Preliminary or Revised. Missing/unavailable calculations stay blank in value. Not every historical observation has its own preliminary qualifier.
source_publication_date Known producer publication associated with the acquired input, YYYY-MM-DD, or Unknown. It is not an inferred first-publication timestamp for each historical observation.
acquired_at UTC timestamp when the site retained the source response. It does not prove that the file was the newest producer release.
source_url Original acquisition endpoint or input-file URL. A request endpoint may require the preserved request parameters from the JSON source manifest.
source_checksum SHA-256 of the exact acquired source input supplying the observation. It is different from the checksum of a generated CSV; distribution checksums are listed separately.
original_producer Original statistical producer, retained even when the acquisition channel has an intermediary.
attribution Source attribution and any required source-specific notice. Retain it when redistributing rows and consult the source-rights register.

Distinguish raw levels from the chart view

The full raw downloads preserve producer units and values, including available seasonal variants. An indicator's default headline may be a monthly difference or growth rate. A displayed CSV follows the selected transformation, range and basis; its values are rounded to the same three decimal places as the table. The snapshot identifies the approved acquired input, while transformation identifies what the website did with it.

Reproduce a row

Use the producer code, period, units, adjustment and transformation together. For example, unemployment LNS14000000 at a raw level is a percentage of the civilian labor force; its previous-period absolute change is in percentage points. Payroll raw levels are thousands of jobs; a displayed monthly difference is a change in those thousands, rather than total employment. Keep unavailable values blank and preserve source status and attribution.

Versions and precision

Existing acquired distributions remain immutable. This dictionary is supplied separately to repair the missing reference in the reviewed README. Observation-level provenance points to exact retained source responses; the approved distribution manifest supplies SHA-256 hashes for generated files. Neither acquisition time nor a displayed update date turns historical observations into an authentic pre-acquisition as-of dataset.

Transformation formulas · Source permissions and attribution · Revision and archive limits.

What can we help you find?

Type at least two letters to start searching.

Browse economic guides Esc to close