BLS Labor Rates
Bureau of Labor Statistics wage and employment statistics.
Source, grain and coverage
Supported federal wage and employment series. Periods and geographic coverage vary by statistical series.
Selected ECI, wage and CPI series have separate publication periods and collection paths. Geographic and occupational coverage is incomplete. Retrieval timestamps do not replace statistical observation periods or establish sampling uncertainty.
Collection schedule: Weekly collection; publication frequency varies by series.
Records describe public source observations. Missing values remain unknown; historical observations do not establish current status.
Definitions audited . Use source status and the returned watermarks to inspect current collection health.
REST and MCP access
Use a credential with intelligence scope and enable that data domain in your workspace.
curl 'https://www.govbiz.ai/api/v2/catalogue/sources/bls-refresh/records?limit=2' \ -H "Authorization: Bearer $GOVBIZ_API_KEY"
The primary dataset is labor_statistics. Select another dataset from this source with dataset_id. Supported field names can be used as exact filters; the versioned query endpoint also supports declared ranges and list operators.
Through canonical /mcp, use govbiz_discover_datasets, govbiz_describe_dataset, govbiz_search_records, and govbiz_get_evidence. Cross-source relationships use govbiz_get_related_records and require access to every involved domain.
API contracts · MCP setup · Workspace data domains
Query this source →Labor Statistics
labor_statistics · Schema 1
One retained selected ECI series/metric/year/quarter observation per id.
Search modes: structured, lexical. History: Current retained projection; exact historical reconstruction is unsupported.
Measures: record_count. Monetary values use decimal strings with declared units. Unknown amounts do not become zero.
Field definitions and supported filters · 13 fields
| Field | Type / unit | Meaning | Availability and filters |
|---|---|---|---|
id | string | GovBiz surrogate row identifier; interpret together with its relation, not as a source-native key.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
series_id | string | BLS statistical series identifier defining population, measure and units.Storage and value limits: Maximum 30 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
series_label | string | Human label for the BLS series.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
ownership_type | string | BLS civilian/private statistical population category; not entity ownership.Storage and value limits: Maximum 20 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
occupation_group | string | BLS occupation grouping for this statistical series.Storage and value limits: Maximum 40 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
seasonal_adjustment | string | Whether the BLS statistical series is seasonally adjusted.Storage and value limits: Maximum 20 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
metric | string | BLS ECI measure type (index or percentage change); value is meaningless without it.Storage and value limits: Maximum 20 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
year | integer | Calendar observation year of a BLS series; not automatically federal fiscal year.Storage and value limits: Signed 32-bit integer; logical domain constraints can be narrower. | Values can be missingeq, in, is_null, gte, lte |
quarter | integer | BLS quarterly observation number; annual rows may use null.Storage and value limits: Signed 32-bit integer; logical domain constraints can be narrower. | Values can be missingeq, in, is_null, gte, lte |
period_type | string | BLS annual/quarterly observation type.Storage and value limits: Maximum 10 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
value | decimal / source_defined | BLS statistical observation value; units depend on series, metric and datatype.Storage and value limits: Precision 10, scale 3; absolute value below 10^7; rounding on assignment; checks can narrow the range. | Values can be missingeq, in, is_null, gte, lte |
snapshot_date | date | Date naming an observed source snapshot; separate from processing time and source event dates.Storage and value limits: Calendar date without time of day or timezone; source precision can be month/quarter instead. | Values can be missingeq, in, is_null, gte, lte |
ingested_at | string | Producer ingestion timestamp; some relations store ISO text and others timestamp without time zone.Storage and value limits: Maximum 40 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
Labor Wage Statistics
labor_wage_statistics · Schema 1
One retained selected wage statistic per series, occupation, datatype, area and survey year, identified by id.
Search modes: structured, lexical. History: Current retained projection; exact historical reconstruction is unsupported.
Measures: record_count. Monetary values use decimal strings with declared units. Unknown amounts do not become zero.
Field definitions and supported filters · 11 fields
| Field | Type / unit | Meaning | Availability and filters |
|---|---|---|---|
id | string | GovBiz surrogate row identifier; interpret together with its relation, not as a source-native key.Storage and value limits: 128-bit identifier; JSON string; does not prove source identity. | Values can be missingeq, in, is_null, contains |
series_id | string | BLS statistical series identifier defining population, measure and units.Storage and value limits: Maximum 30 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
series_label | string | Human label for the BLS series.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
occupation_code | string | Occupation/SOC-related identifier used by the selected BLS series.Storage and value limits: Maximum 10 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
occupation_label | string | Occupation label used by the selected BLS wage series.Storage and value limits: No declared field-length cap here; API/output budgets must apply; empty and null differ. | Values can be missingeq, in, is_null, contains |
datatype | string | BLS wage statistic category, such as annual/hourly mean; determines value units.Storage and value limits: Maximum 30 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
area_type | string | BLS geographic population category; it does not provide every locality.Storage and value limits: Maximum 20 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
value | decimal / source_defined | BLS statistical observation value; units depend on series, metric and datatype.Storage and value limits: Precision 15, scale 2; absolute value below 10^13; rounding on assignment; checks can narrow the range. | Values can be missingeq, in, is_null, gte, lte |
survey_year | integer | BLS wage survey/reference year; separate from the collection snapshot date.Storage and value limits: Signed 32-bit integer; logical domain constraints can be narrower. | Values can be missingeq, in, is_null, gte, lte |
snapshot_date | date | Date naming an observed source snapshot; separate from processing time and source event dates.Storage and value limits: Calendar date without time of day or timezone; source precision can be month/quarter instead. | Values can be missingeq, in, is_null, gte, lte |
ingested_at | string | Producer ingestion timestamp; some relations store ISO text and others timestamp without time zone.Storage and value limits: Maximum 40 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
Consumer Price Statistics
consumer_price_statistics · Schema 1
One retained CPI observation per series_id, year and period; publication frequency differs from collection frequency.
Search modes: structured, lexical. History: Current retained projection; exact historical reconstruction is unsupported.
Measures: record_count. Monetary values use decimal strings with declared units. Unknown amounts do not become zero.
Field definitions and supported filters · 10 fields
| Field | Type / unit | Meaning | Availability and filters |
|---|---|---|---|
series_id | string | BLS statistical series identifier defining population, measure and units.Storage and value limits: Maximum 30 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
series_label | string | Human label for the BLS series.Storage and value limits: Maximum 200 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
year | integer | Calendar observation year of a BLS series; not automatically federal fiscal year.Storage and value limits: Signed 32-bit integer; logical domain constraints can be narrower. | Values can be missingeq, in, is_null, gte, lte |
period | string | BLS source period code; month/annual conventions vary by series.Storage and value limits: Maximum 5 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
period_name | string | BLS source human period label.Storage and value limits: Maximum 30 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |
value | decimal / source_defined | BLS consumer-price statistical observation; series_id, base period and period determine the index units. It is not a labor wage or contract rate.Storage and value limits: Precision 10, scale 3; absolute value below 10^7; rounding on assignment; checks can narrow the range. | Values can be missingeq, in, is_null, gte, lte |
annual_pct_change | decimal | Year-over-year index/statistical percent change, not a dollar amount.Storage and value limits: Precision 8, scale 4; absolute value below 10^4; rounding on assignment; checks can narrow the range. | Values can be missingeq, in, is_null, gte, lte |
monthly_pct_change | decimal | Month-over-month statistical percent change, not a dollar amount.Storage and value limits: Precision 8, scale 4; absolute value below 10^4; rounding on assignment; checks can narrow the range. | Values can be missingeq, in, is_null, gte, lte |
ingested_at | datetime | Producer ingestion timestamp; some relations store ISO text and others timestamp without time zone.Storage and value limits: Instant with timezone only if declared; otherwise local/producer time must be explicitly interpreted. Do not invent clock precision. | Values can be missingeq, in, is_null, gte, lte |
category | string | Source classification grouping; interpretation differs between CALC+ and CPI.Storage and value limits: Maximum 50 characters; identifier rules can be narrower. | Values can be missingeq, in, is_null, contains |