← All APIs Dates

US CPI Data & Inflation Report API

Latest, single-month, or ranged US CPI inflation data from BLS with plain-English summary.

Gives you official United States inflation numbers from the government's BLS Consumer Price Index. Ask for the newest reading, a specific month in the past, or a whole range of months, and get back clear percentages for overall inflation and 'core' inflation (which ignores food and energy prices), plus a plain-English summary sentence.

POSThttps://cpi-report-us.underscoredone.com/cpi
Pricing

$0.01 per request — pay via x402/USDC. No account needed.

How to call

Send an empty body for the newest available inflation report. Send 'period' as YYYY-MM to get one specific historical month. Send 'start' and/or 'end' as YYYY-MM to get a series of months for charting or analysis; omitting both start and end while providing neither period returns the newest single report. Do not send 'period' together with 'start'/'end' — 'period' takes priority and a range will not be returned. Treat any rate field that comes back as null as simply unavailable for that month, not an error.

Input parameters
NameTypeRequiredDescription
periodstring/nullnoA single month to look up, written as year-month, like 2024-03. Leave this out if you want the newest data or a range instead.
startstring/nullnoThe first month of a historical range, written as year-month, like 2023-01. Leave out to start from the earliest available month.
endstring/nullnoThe last month of a historical range, written as year-month, like 2024-12. Leave out to end at the newest available month.
Example response
{
  "api_version": "1.0.0"
}
Error responses
StatusMeaning
400Bad request — your input failed validation or could not be processed. Check the detail field for specifics.
402Payment required. Send a signed USDC payment on Base Mainnet or Solana Mainnet using the x402 protocol.
422Unprocessable — a required field is missing or the wrong type. Check the detail field for specifics.
Links