{"openapi":"3.1.0","info":{"title":"US Labor Statistics API","version":"1.0.0","description":"Official US economic indicators straight from the US Bureau of Labor Statistics (BLS) public time-series API — no key, read live. The cpi endpoint returns the Consumer Price Index for All Urban Consumers (CPI-U, all items, series CUUR0000SA0) for the latest month with the index level plus the month-on-month and year-on-year inflation rates, computed from the official series. The unemployment endpoint returns the seasonally-adjusted US unemployment rate (series LNS14000000) for the latest month plus the trailing year. The indicators endpoint returns a curated dashboard of headline US figures in one call — CPI, core CPI, the unemployment rate, the producer price index, average hourly earnings and total nonfarm employment — each with its latest value and period. The series endpoint is a thin live gateway to any BLS series by its id, returning the data points and computed changes, opening up the full BLS catalogue (prices, employment, wages, productivity). Annual-average rows are labelled and excluded from period maths. Live data from BLS, heavily cached because the public API is rate-limited. Live. 5 endpoints. This serves US national statistics; for the US dollar exchange rate or Treasury yields use an FX / Treasury API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bls-api","description":"oanor gateway"}],"tags":[{"name":"Inflation"},{"name":"Labor"},{"name":"Dashboard"},{"name":"Catalogue"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/cpi":{"get":{"operationId":"get_v1_cpi","tags":["Inflation"],"summary":"US CPI-U (latest month): index, MoM and YoY","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"1982-84 = 100","index":335.123,"period":"2026 May","source":"US Bureau of Labor Statistics (series CUUR0000SA0)","country":"United States","indicator":"Consumer Price Index for All Urban Consumers (CPI-U, all items)","period_iso":"2026-05","change_mom_pct":0.63,"change_yoy_pct":4.25},"meta":{"timestamp":"2026-06-15T20:40:38.984Z","request_id":"e28020c2-664a-415d-854f-96061a1596f5"},"status":"ok","message":"US CPI retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/unemployment":{"get":{"operationId":"get_v1_unemployment","tags":["Labor"],"summary":"US unemployment rate (latest + trailing year)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"period":"2026 May","recent":[{"period":"2026 May","rate_pct":4.3,"period_iso":"2026-05"},{"period":"2026 April","rate_pct":4.3,"period_iso":"2026-04"},{"period":"2026 March","rate_pct":4.3,"period_iso":"2026-03"},{"period":"2026 February","rate_pct":4.4,"period_iso":"2026-02"},{"period":"2026 January","rate_pct":4.3,"period_iso":"2026-01"},{"period":"2025 December","rate_pct":4.4,"period_iso":"2025-12"},{"period":"2025 November","rate_pct":4.5,"period_iso":"2025-11"},{"period":"2025 October","period_iso":"2025-10"},{"period":"2025 September","rate_pct":4.4,"period_iso":"2025-09"},{"period":"2025 August","rate_pct":4.3,"period_iso":"2025-08"},{"period":"2025 July","rate_pct":4.3,"period_iso":"2025-07"},{"period":"2025 June","rate_pct":4.1,"period_iso":"2025-06"},{"period":"2025 May","rate_pct":4.3,"period_iso":"2025-05"}],"source":"US Bureau of Labor Statistics (series LNS14000000)","country":"United States","rate_pct":4.3,"indicator":"Unemployment rate (16 years and over, seasonally adjusted)","period_iso":"2026-05"},"meta":{"timestamp":"2026-06-15T20:40:39.118Z","request_id":"bbe4c8ae-0b89-483c-a4e0-24f19cf1acd5"},"status":"ok","message":"US unemployment retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/indicators":{"get":{"operationId":"get_v1_indicators","tags":["Dashboard"],"summary":"Dashboard of headline US indicators","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":6,"source":"US Bureau of Labor Statistics","country":"United States","indicators":[{"key":"cpi","unit":"index","label":"CPI-U, all items (1982-84=100, NSA)","value":335.123,"period":"2026 May","series_id":"CUUR0000SA0","period_iso":"2026-05"},{"key":"core_cpi","unit":"index","label":"Core CPI-U (all items less food & energy)","value":336.846,"period":"2026 May","series_id":"CUUR0000SA0L1E","period_iso":"2026-05"},{"key":"unemployment_rate","unit":"percent","label":"Unemployment rate (16+, seasonally adjusted)","value":4.3,"period":"2026 May","series_id":"LNS14000000","period_iso":"2026-05"},{"key":"ppi_final_demand","unit":"index","label":"PPI, final demand","value":158.012,"period":"2026 May","series_id":"WPUFD4","period_iso":"2026-05"},{"key":"avg_hourly_earnings","unit":"usd","label":"Average hourly earnings, total private (USD)","value":37.53,"period":"2026 May","series_id":"CES0500000003","period_iso":"2026-05"},{"key":"nonfarm_employment","unit":"thousands","label":"Total nonfarm employment (thousands)","value":159001,"period":"2026 May","series_id":"CES0000000001","period_iso":"2026-05"}]},"meta":{"timestamp":"2026-06-15T20:40:39.183Z","request_id":"89997a23-2e5f-4bbe-9032-8dc670fb6a92"},"status":"ok","message":"US key indicators retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/series":{"get":{"operationId":"get_v1_series","tags":["Catalogue"],"summary":"Fetch any BLS time series by id","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"BLS series id (default CUUR0000SA0 = CPI-U all items)","schema":{"type":"string"},"example":"CUUR0000SA0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":31,"latest":{"value":335.123,"period":"2026 May","period_iso":"2026-05"},"points":[{"value":335.123,"period":"2026 May","period_iso":"2026-05"},{"value":333.02,"period":"2026 April","period_iso":"2026-04"},{"value":330.213,"period":"2026 March","period_iso":"2026-03"},{"value":326.785,"period":"2026 February","period_iso":"2026-02"},{"value":325.252,"period":"2026 January","period_iso":"2026-01"},{"value":321.943,"period":"2025 Annual","period_iso":"2025-annual"},{"value":324.054,"period":"2025 December","period_iso":"2025-12"},{"value":324.122,"period":"2025 November","period_iso":"2025-11"},{"period":"2025 October","period_iso":"2025-10"},{"value":324.8,"period":"2025 September","period_iso":"2025-09"},{"value":323.976,"period":"2025 August","period_iso":"2025-08"},{"value":323.048,"period":"2025 July","period_iso":"2025-07"},{"value":322.561,"period":"2025 June","period_iso":"2025-06"},{"value":321.465,"period":"2025 May","period_iso":"2025-05"},{"value":320.795,"period":"2025 April","period_iso":"2025-04"},{"value":319.799,"period":"2025 March","period_iso":"2025-03"},{"value":319.082,"period":"2025 February","period_iso":"2025-02"},{"value":317.671,"period":"2025 January","period_iso":"2025-01"},{"value":313.689,"period":"2024 Annual","period_iso":"2024-annual"},{"value":315.605,"period":"2024 December","period_iso":"2024-12"},{"value":315.493,"period":"2024 November","period_iso":"2024-11"},{"value":315.664,"period":"2024 October","period_iso":"2024-10"},{"value":315.301,"period":"2024 September","period_iso":"2024-09"},{"value":314.796,"period":"2024 August","period_iso":"2024-08"},{"value":314.54,"period":"2024 July","period_iso":"2024-07"},{"value":314.175,"period":"2024 June","period_iso":"2024-06"},{"value":314.069,"period":"2024 May","period_iso":"2024-05"},{"value":313.548,"period":"2024 April","period_iso":"2024-04"},{"value":312.332,"period":"2024 March","period_iso":"2024-03"},{"value":310.326,"period":"2024 February","period_iso":"2024-02"},{"value":308.417,"period":"2024 January","period_iso":"2024-01"}],"source":"US Bureau of Labor Statistics","series_id":"CUUR0000SA0","change_mom_pct":0.63,"change_yoy_pct":4.25},"meta":{"timestamp":"2026-06-15T20:40:39.268Z","request_id":"41488847-ab8b-4b83-9e67-851a650bb96b"},"status":"ok","message":"BLS series retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"API metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"api":"US Bureau of Labor Statistics (BLS) API","notes":"Live data from BLS; the BLS public API returns roughly the last three years per series. Heavily cached (6h) because BLS rate-limits unregistered use; month-on-month and year-on-year computed from the series.","source":"US Bureau of Labor Statistics — public Time Series API v1 (api.bls.gov)","country":"United States","endpoints":["/v1/cpi","/v1/unemployment","/v1/indicators","/v1/series","/v1/meta"],"indicators":[{"key":"cpi","label":"CPI-U, all items (1982-84=100, NSA)","series_id":"CUUR0000SA0"},{"key":"core_cpi","label":"Core CPI-U (all items less food & energy)","series_id":"CUUR0000SA0L1E"},{"key":"unemployment_rate","label":"Unemployment rate (16+, seasonally adjusted)","series_id":"LNS14000000"},{"key":"ppi_final_demand","label":"PPI, final demand","series_id":"WPUFD4"},{"key":"avg_hourly_earnings","label":"Average hourly earnings, total private (USD)","series_id":"CES0500000003"},{"key":"nonfarm_employment","label":"Total nonfarm employment (thousands)","series_id":"CES0000000001"}],"documentation":"https://bls-api.oanor.dev"},"meta":{"timestamp":"2026-06-15T20:40:39.355Z","request_id":"0dc7c92e-6433-4df3-bc7d-fd5e92d7f305"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":310,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1180,"monthly_call_quota":21000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3120,"monthly_call_quota":108000,"rps_limit":22,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6980,"monthly_call_quota":490000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bls-api"}