# CPI Inflation Rate API > The headline consumer-price inflation print for every major economy, broken into its core and its drivers, live from the OECD's official price statistics — no key. Consumer-price inflation is the single most-watched macro number on earth: the gauge every central bank targets, the thing that sets the real value of wages, debts and savings, and a number whose surprises move bonds, currencies and equities within seconds. This API serves the year-on-year national CPI the way it is actually reported, for ~50 economies — and crucially it does not stop at the headline. For each economy it also serves the core rate (all items excluding food and energy, the measure policymakers really steer by), plus the food, energy and services rates themselves. That decomposition tells you whether a reading is a temporary food/energy shock or a stickier, demand-driven core problem: headline above core means volatile food/energy are pushing prices up; headline below core means they are dragging the print down while underlying inflation stays hot. The board endpoint ranks economies by headline inflation with core alongside; core ranks by the core rate; country gives one economy's full breakdown with the headline-vs-core read. Each reading carries its own month and discontinued series are filtered out, so the board is genuinely current. This is the realised-inflation cut — distinct from the inflation calculator (arithmetic from a rate you supply, not live data), from consumer inflation expectations (a survey of what households think prices will do, not what they did), and from unit labour costs and wages. Rates are percent year-on-year; figures are monthly. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/cpiinflation-api/..." ``` ## Pricing - **Free** (Free) — 700 calls/Mo, 2 req/s - **Starter** ($13/Mo) — 14,800 calls/Mo, 6 req/s - **Pro** ($39/Mo) — 78,000 calls/Mo, 16 req/s - **Mega** ($87/Mo) — 452,000 calls/Mo, 40 req/s ## Endpoints ### Country #### `GET /v1/country` — One economy's full inflation breakdown **Parameters:** - `country` (query, required, string) — ISO-3 code or country name Example: `USA` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/cpiinflation-api/v1/country?country=USA" ``` **Response:** ```json { "data": { "code": "USA", "core": 2.85, "food": 2.74, "name": "United States", "note": "One economy's consumer-price inflation, broken down: the headline all-items rate, the core rate (excluding food and energy), and the food, energy and services rates — each year-on-year. The headline-vs-core read tells you whether the inflation is a food/energy shock or a stickier underlying problem. A component is null when that series is not currently reported for this economy. Percent year-on-year, monthly, cached a few hours.", "energy": 23.54, "period": "2026-05", "source": "OECD price statistics (SDMX), national CPI", "headline": 4.25, "services": null, "is_aggregate": false, "headline_vs_core": "Headline (4.25%) is running above core (2.85%) by 1.4 pts — volatile food/energy are pushing the print up; underlying inflation is cooler than the headline suggests." }, "meta": { "timestamp": "2026-06-12T19:36:28.249Z", "request_id": "9f534f66-cbeb-44d7-94cc-8182d149d4c8" }, "status": "ok", "message": "Country CPI inflation retrieved successfully", "success": true } ``` ### Board #### `GET /v1/board` — Economies ranked by headline CPI inflation **Parameters:** - `countries_only` (query, optional, string) — true to drop aggregates (euro area, OECD total) Example: `true` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/cpiinflation-api/v1/board?countries_only=true" ``` **Response:** ```json { "data": { "note": "Economies ranked by headline consumer-price inflation — the year-on-year growth of the national all-items CPI, the way it is reported. The core rate (excluding food and energy) is shown alongside so you can see, at a glance, where the headline is being driven by volatile food/energy versus stickier underlying inflation. Each row carries its own month; discontinued series excluded. Pass countries_only=true to drop aggregates such as the euro area or OECD total. Monthly, cached a few hours.", "board": [ { "code": "ARG", "core": null, "food": 30.87, "name": "Argentina", "energy": null, "period": "2026-04", "headline": 32.35, "services": 43.13, "is_aggregate": false }, { "code": "TUR", "core": 32.04, "food": 28.31, "name": "Türkiye", "energy": 29.39, "period": "2025-12", "headline": 30.89, "services": null, "is_aggregate": false }, { "code": "COL", "core": 6.28, "food": 6.7, "name": "Colombia", "energy": -1.78, "period": "2026-04", "headline": 5.68, "services": 7.31, …(truncated, see openapi.json for full schema) ``` #### `GET /v1/core` — Economies ranked by core CPI inflation (ex food & energy) **Parameters:** - `countries_only` (query, optional, string) — true to drop aggregates Example: `true` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/cpiinflation-api/v1/core?countries_only=true" ``` **Response:** ```json { "data": { "note": "Economies ranked by core consumer-price inflation — all items excluding food and energy, the measure central banks really steer by because it strips out the two most volatile components and reveals underlying price pressure. The headline rate is shown alongside. Each row carries its own month; discontinued series excluded. Pass countries_only=true to drop aggregates. Monthly, cached a few hours.", "board": [ { "code": "TUR", "core": 32.04, "food": 28.31, "name": "Türkiye", "energy": 29.39, "period": "2025-12", "headline": 30.89, "services": null, "is_aggregate": false }, { "code": "COL", "core": 6.28, "food": 6.7, "name": "Colombia", "energy": -1.78, "period": "2026-04", "headline": 5.68, "services": 7.31, "is_aggregate": false }, { "code": "EST", "core": 5.78, "food": 5.58, "name": "Estonia", "energy": -4.99, "period": "2025-12", "headline": 4.08, "services": 10.03, "is_aggregate": false }, { "code": "HUN", …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/cpiinflation-api/v1/meta" ``` **Response:** ```json { "data": { "note": "board and core take countries_only (true to drop aggregates such as the euro area or OECD total). country takes country (ISO-3 code or name, required). meta takes no parameters. Rates are percent year-on-year; the core rate excludes food and energy. Each row carries its own month; discontinued national series are filtered out. Monthly data; a multi-hour protective cache fronts the OECD upstream.", "source": "OECD price statistics (DF_PRICES_ALL, national CPI, GY year-on-year) via OECD SDMX API, percent per annum, live, keyless", "service": "cpiinflation-api", "economies": 46, "endpoints": { "GET /v1/core": "Economies ranked by core CPI inflation (excluding food & energy).", "GET /v1/meta": "This document.", "GET /v1/board": "Economies ranked by headline CPI inflation, core shown alongside (countries_only optional).", "GET /v1/country": "One economy's full inflation breakdown — headline, core, food, energy, services (country=USA)." }, "description": "Live CPI inflation rate by country — the headline consumer-price inflation print broken into its core and its drivers, from the OECD's official price statistics (no key). It exposes the year-on-year national CPI: the headline all-items rate, the core rate (excluding food and energy) that central banks steer by, and the food, energy and services component rates, for ~50 economies. board ranks by headl …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/cpiinflation-api OpenAPI spec: https://www.oanor.com/api/cpiinflation-api/openapi.json