{"openapi":"3.1.0","info":{"title":"CPI Inflation Rate API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cpiinflation-api","description":"oanor gateway"}],"tags":[{"name":"Country"},{"name":"Board"},{"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/country":{"get":{"operationId":"get_v1_country","tags":["Country"],"summary":"One economy's full inflation breakdown","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"ISO-3 code or country name","schema":{"type":"string"},"example":"USA"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"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}}}},"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/board":{"get":{"operationId":"get_v1_board","tags":["Board"],"summary":"Economies ranked by headline CPI inflation","description":"","parameters":[{"name":"countries_only","in":"query","required":false,"description":"true to drop aggregates (euro area, OECD total)","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","food":30.87,"name":"Argentina","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,"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":"BGR","core":4.96,"food":5.6,"name":"Bulgaria","energy":3.58,"period":"2025-12","headline":4.95,"is_aggregate":false},{"code":"ISL","core":4.26,"food":5.49,"name":"Iceland","energy":4.89,"period":"2025-12","headline":4.49,"is_aggregate":false},{"code":"IND","name":"India","period":"2026-04","headline":4.46,"is_aggregate":false},{"code":"BRA","name":"Brazil","period":"2026-04","headline":4.39,"is_aggregate":false},{"code":"USA","core":2.85,"food":2.74,"name":"United States","energy":23.54,"period":"2026-05","headline":4.25,"is_aggregate":false},{"code":"AUS","core":3.33,"food":2.78,"name":"Australia","period":"2026-04","headline":4.18,"services":3.53,"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":"SVK","core":4.85,"food":2.78,"name":"Slovak Republic","energy":0.25,"period":"2025-12","headline":3.87,"services":5.07,"is_aggregate":false},{"code":"AUT","core":3.18,"food":3.9,"name":"Austria","energy":8.9,"period":"2025-12","headline":3.76,"services":4.43,"is_aggregate":false},{"code":"LVA","core":3.14,"food":4.23,"name":"Latvia","energy":3.48,"period":"2025-12","headline":3.49,"services":5.69,"is_aggregate":false},{"code":"LTU","core":4.26,"food":4.05,"name":"Lithuania","energy":-1.44,"period":"2025-12","headline":3.45,"services":5.69,"is_aggregate":false},{"code":"HUN","core":5.08,"food":-0.3,"name":"Hungary","energy":-2.12,"period":"2025-12","headline":3.3,"services":7.5,"is_aggregate":false},{"code":"HRV","core":3.34,"food":2.8,"name":"Croatia","energy":5.18,"period":"2025-12","headline":3.3,"is_aggregate":false},{"code":"NOR","core":2.86,"food":5.22,"name":"Norway","energy":3.73,"period":"2025-12","headline":3.19,"is_aggregate":false},{"code":"KOR","core":2.54,"food":1.61,"name":"Korea","energy":12.52,"period":"2026-05","headline":3.14,"services":2.82,"is_aggregate":false},{"code":"IDN","name":"Indonesia","period":"2026-05","headline":3.08,"is_aggregate":false},{"code":"LUX","core":2.12,"food":3.43,"name":"Luxembourg","energy":14.46,"period":"2025-12","headline":3.06,"services":2.73,"is_aggregate":false},{"code":"GBR","core":2.8,"food":3,"name":"United Kingdom","energy":7.1,"period":"2026-04","headline":3,"services":3.4,"is_aggregate":false},{"code":"ESP","core":2.77,"food":2.99,"name":"Spain","energy":3.37,"period":"2025-12","headline":2.92,"services":3.66,"is_aggregate":false},{"code":"DEU","core":2.34,"food":1.54,"name":"Germany","energy":10.67,"period":"2026-04","headline":2.88,"is_aggregate":false},{"code":"CAN","name":"Canada","period":"2026-04","headline":2.82,"is_aggregate":false},{"code":"NLD","core":2.92,"food":3.28,"name":"Netherlands","energy":-0.36,"period":"2025-12","headline":2.77,"services":4.15,"is_aggregate":false},{"code":"IRL","core":2.62,"food":4.12,"name":"Ireland","energy":2.41,"period":"2025-12","headline":2.76,"services":3.51,"is_aggregate":false},{"code":"SVN","core":2.34,"food":4.51,"name":"Slovenia","energy":1.87,"period":"2025-12","headline":2.71,"services":3.55,"is_aggregate":false},{"code":"GRC","core":2.99,"food":3.63,"name":"Greece","energy":-1.27,"period":"2025-12","headline":2.59,"services":4.65,"is_aggregate":false},{"code":"POL","core":2.7,"food":2.4,"name":"Poland","energy":0.9,"period":"2025-12","headline":2.4,"services":5.2,"is_aggregate":false},{"code":"PRT","core":2.05,"food":3.47,"name":"Portugal","energy":-2.38,"period":"2025-12","headline":2.19,"services":3.86,"is_aggregate":false},{"code":"CZE","core":3.34,"food":1.7,"name":"Czechia","energy":-4.06,"period":"2025-12","headline":2.11,"services":4.76,"is_aggregate":false},{"code":"BEL","core":3.07,"food":2.81,"name":"Belgium","energy":-5,"period":"2025-12","headline":2.06,"services":4.54,"is_aggregate":false},{"code":"ISR","core":1.52,"food":2.93,"name":"Israel","energy":5.77,"period":"2026-04","headline":1.94,"services":1.43,"is_aggregate":false},{"code":"DNK","core":2.19,"food":3.55,"name":"Denmark","energy":-3.83,"period":"2025-12","headline":1.93,"services":3.38,"is_aggregate":false},{"code":"CHN","food":-1.7,"name":"China (People’s Republic of)","period":"2026-05","headline":1.2,"is_aggregate":false},{"code":"ITA","core":1.71,"food":2.35,"name":"Italy","energy":-4.49,"period":"2025-12","headline":1.16,"services":2.49,"is_aggregate":false},{"code":"FRA","core":1.41,"food":1.83,"name":"France","energy":-6.56,"period":"2025-12","headline":0.79,"services":2.12,"is_aggregate":false},{"code":"SWE","core":-0.15,"food":3.72,"name":"Sweden","energy":-1,"period":"2025-12","headline":0.3,"is_aggregate":false},{"code":"FIN","core":-0.13,"food":2.01,"name":"Finland","energy":0.83,"period":"2025-12","headline":0.23,"services":-0.4,"is_aggregate":false},{"code":"CHE","core":0.52,"food":-0.83,"name":"Switzerland","energy":-5.32,"period":"2025-12","headline":0.06,"services":1.17,"is_aggregate":false}],"count":40,"source":"OECD price statistics (SDMX), national CPI, percent year-on-year","indicator":"Headline CPI inflation (year-on-year)","latest_period":"2026-05"},"meta":{"timestamp":"2026-06-12T19:36:28.344Z","request_id":"13ff3aeb-e97d-4d08-badd-881573d62b0d"},"status":"ok","message":"Headline CPI inflation board retrieved successfully","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/core":{"get":{"operationId":"get_v1_core","tags":["Board"],"summary":"Economies ranked by core CPI inflation (ex food & energy)","description":"","parameters":[{"name":"countries_only","in":"query","required":false,"description":"true to drop aggregates","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"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","core":5.08,"food":-0.3,"name":"Hungary","energy":-2.12,"period":"2025-12","headline":3.3,"services":7.5,"is_aggregate":false},{"code":"BGR","core":4.96,"food":5.6,"name":"Bulgaria","energy":3.58,"period":"2025-12","headline":4.95,"is_aggregate":false},{"code":"SVK","core":4.85,"food":2.78,"name":"Slovak Republic","energy":0.25,"period":"2025-12","headline":3.87,"services":5.07,"is_aggregate":false},{"code":"LTU","core":4.26,"food":4.05,"name":"Lithuania","energy":-1.44,"period":"2025-12","headline":3.45,"services":5.69,"is_aggregate":false},{"code":"ISL","core":4.26,"food":5.49,"name":"Iceland","energy":4.89,"period":"2025-12","headline":4.49,"is_aggregate":false},{"code":"CZE","core":3.34,"food":1.7,"name":"Czechia","energy":-4.06,"period":"2025-12","headline":2.11,"services":4.76,"is_aggregate":false},{"code":"HRV","core":3.34,"food":2.8,"name":"Croatia","energy":5.18,"period":"2025-12","headline":3.3,"is_aggregate":false},{"code":"AUS","core":3.33,"food":2.78,"name":"Australia","period":"2026-04","headline":4.18,"services":3.53,"is_aggregate":false},{"code":"AUT","core":3.18,"food":3.9,"name":"Austria","energy":8.9,"period":"2025-12","headline":3.76,"services":4.43,"is_aggregate":false},{"code":"LVA","core":3.14,"food":4.23,"name":"Latvia","energy":3.48,"period":"2025-12","headline":3.49,"services":5.69,"is_aggregate":false},{"code":"BEL","core":3.07,"food":2.81,"name":"Belgium","energy":-5,"period":"2025-12","headline":2.06,"services":4.54,"is_aggregate":false},{"code":"GRC","core":2.99,"food":3.63,"name":"Greece","energy":-1.27,"period":"2025-12","headline":2.59,"services":4.65,"is_aggregate":false},{"code":"NLD","core":2.92,"food":3.28,"name":"Netherlands","energy":-0.36,"period":"2025-12","headline":2.77,"services":4.15,"is_aggregate":false},{"code":"NOR","core":2.86,"food":5.22,"name":"Norway","energy":3.73,"period":"2025-12","headline":3.19,"is_aggregate":false},{"code":"USA","core":2.85,"food":2.74,"name":"United States","energy":23.54,"period":"2026-05","headline":4.25,"is_aggregate":false},{"code":"GBR","core":2.8,"food":3,"name":"United Kingdom","energy":7.1,"period":"2026-04","headline":3,"services":3.4,"is_aggregate":false},{"code":"ESP","core":2.77,"food":2.99,"name":"Spain","energy":3.37,"period":"2025-12","headline":2.92,"services":3.66,"is_aggregate":false},{"code":"POL","core":2.7,"food":2.4,"name":"Poland","energy":0.9,"period":"2025-12","headline":2.4,"services":5.2,"is_aggregate":false},{"code":"IRL","core":2.62,"food":4.12,"name":"Ireland","energy":2.41,"period":"2025-12","headline":2.76,"services":3.51,"is_aggregate":false},{"code":"KOR","core":2.54,"food":1.61,"name":"Korea","energy":12.52,"period":"2026-05","headline":3.14,"services":2.82,"is_aggregate":false},{"code":"SVN","core":2.34,"food":4.51,"name":"Slovenia","energy":1.87,"period":"2025-12","headline":2.71,"services":3.55,"is_aggregate":false},{"code":"DEU","core":2.34,"food":1.54,"name":"Germany","energy":10.67,"period":"2026-04","headline":2.88,"is_aggregate":false},{"code":"DNK","core":2.19,"food":3.55,"name":"Denmark","energy":-3.83,"period":"2025-12","headline":1.93,"services":3.38,"is_aggregate":false},{"code":"LUX","core":2.12,"food":3.43,"name":"Luxembourg","energy":14.46,"period":"2025-12","headline":3.06,"services":2.73,"is_aggregate":false},{"code":"PRT","core":2.05,"food":3.47,"name":"Portugal","energy":-2.38,"period":"2025-12","headline":2.19,"services":3.86,"is_aggregate":false},{"code":"ITA","core":1.71,"food":2.35,"name":"Italy","energy":-4.49,"period":"2025-12","headline":1.16,"services":2.49,"is_aggregate":false},{"code":"ISR","core":1.52,"food":2.93,"name":"Israel","energy":5.77,"period":"2026-04","headline":1.94,"services":1.43,"is_aggregate":false},{"code":"FRA","core":1.41,"food":1.83,"name":"France","energy":-6.56,"period":"2025-12","headline":0.79,"services":2.12,"is_aggregate":false},{"code":"CHE","core":0.52,"food":-0.83,"name":"Switzerland","energy":-5.32,"period":"2025-12","headline":0.06,"services":1.17,"is_aggregate":false},{"code":"FIN","core":-0.13,"food":2.01,"name":"Finland","energy":0.83,"period":"2025-12","headline":0.23,"services":-0.4,"is_aggregate":false},{"code":"SWE","core":-0.15,"food":3.72,"name":"Sweden","energy":-1,"period":"2025-12","headline":0.3,"is_aggregate":false}],"count":34,"source":"OECD price statistics (SDMX), national CPI, percent year-on-year","indicator":"Core CPI inflation (excluding food & energy, year-on-year)","latest_period":"2026-05"},"meta":{"timestamp":"2026-06-12T19:36:28.439Z","request_id":"a2e53d84-e78f-4338-be5e-907e317a421e"},"status":"ok","message":"Core CPI inflation board retrieved successfully","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":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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 headline with core alongside; core ranks by the core rate; country gives one economy's full breakdown with a headline-vs-core read. The realised-inflation cut — distinct from the inflation calculator (arithmetic, not live data), consumer inflation expectations (a survey of what households expect, not what prices did), and unit labour costs/wages.","united_states":{"code":"USA","core":2.85,"food":2.74,"name":"United States","energy":23.54,"period":"2026-05","headline":4.25,"is_aggregate":false},"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T19:36:28.528Z","request_id":"e2b2ae82-cb4f-49aa-9979-94ef85650c1e"},"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":700,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1250,"monthly_call_quota":14800,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3850,"monthly_call_quota":78000,"rps_limit":16,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":8650,"monthly_call_quota":452000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cpiinflation-api"}