{"openapi":"3.1.0","info":{"title":"Åland Consumer Price Index API","version":"1.0.0","description":"Official consumer-price-index and inflation data for the Åland Islands — the autonomous, Swedish-speaking, euro-area region of Finland — sourced live from Statistics and Research Åland (ÅSUB), the regional statistics authority, via its public PxWeb API (table KO010). The overall endpoint returns the latest headline CPI level (index base 2025 = 100) together with month-on-month and year-on-year change. The series endpoint returns the full monthly history of the headline index with monthly and annual change, parameterised by the number of months. The divisions endpoint breaks the basket down across the thirteen COICOP groups — food, alcohol & tobacco, clothing, housing & utilities, furnishings, health, transport, communication, recreation & culture, education, restaurants & hotels, miscellaneous and personal care — each with its index level and annual change. The drivers endpoint ranks those same divisions by their annual impact in percentage points, showing exactly which categories are pushing Åland inflation up or down. Figures are published directly by ÅSUB, not modelled or estimated, and are refreshed from source. Ideal for macro and regional-economics dashboards, cost-of-living and salary tools, Nordic and euro-area inflation trackers, and fintech that needs a clean, structured CPI feed for a market the big aggregators ignore. Live keyless upstream, short server-side cache. 5 endpoints.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/aland-stats-api","description":"oanor gateway"}],"tags":[{"name":"CPI"},{"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":["CPI"],"summary":"Headline CPI (latest)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"2025 = 100","index":101.73,"period":"2026M05","region":"Åland Islands","source":"Statistics and Research Åland (ÅSUB, table KO010)","indicator":"Consumer Price Index (overall)","period_iso":"2026-05","change_mom_pct":0.4,"change_yoy_pct":1.7},"meta":{"timestamp":"2026-06-15T20:40:29.044Z","request_id":"a42b80ba-a30a-47b7-bdfb-5dd75043c14b"},"status":"ok","message":"Åland 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/cpi/divisions":{"get":{"operationId":"get_v1_cpi_divisions","tags":["CPI"],"summary":"CPI by COICOP division","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"2025 = 100","count":13,"period":"2026M05","region":"Åland Islands","source":"ÅSUB KO010","divisions":[{"index":101.32,"label":"Food & non-alcoholic beverages","coicop":"01","change_yoy_pct":1.1},{"index":102.72,"label":"Alcoholic beverages & tobacco","coicop":"02","change_yoy_pct":3.2},{"index":100.79,"label":"Clothing & footwear","coicop":"03","change_yoy_pct":0.5},{"index":99.75,"label":"Housing, water, electricity, gas & fuels","coicop":"04","change_yoy_pct":0.5},{"index":102.12,"label":"Furnishings & household equipment","coicop":"05","change_yoy_pct":1.1},{"index":111.85,"label":"Health","coicop":"06","change_yoy_pct":5.5},{"index":105.12,"label":"Transport","coicop":"07","change_yoy_pct":5.7},{"index":102.83,"label":"Communication","coicop":"08","change_yoy_pct":3.5},{"index":101.45,"label":"Recreation & culture","coicop":"09","change_yoy_pct":1.8},{"index":106.25,"label":"Education","coicop":"10","change_yoy_pct":6.2},{"index":102.45,"label":"Restaurants & hotels","coicop":"11","change_yoy_pct":2.6},{"index":97.91,"label":"Miscellaneous goods & services","coicop":"12","change_yoy_pct":-2.9},{"index":98.17,"label":"Other / personal care","coicop":"13","change_yoy_pct":-2}],"indicator":"CPI by COICOP division","period_iso":"2026-05"},"meta":{"timestamp":"2026-06-15T20:40:29.145Z","request_id":"01f76768-12b5-471a-b607-bf17fdb7ccbc"},"status":"ok","message":"Åland CPI by division 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/cpi/drivers":{"get":{"operationId":"get_v1_cpi_drivers","tags":["CPI"],"summary":"Inflation drivers (annual impact)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":13,"period":"2026M05","region":"Åland Islands","source":"ÅSUB KO010","drivers":[{"label":"Transport","coicop":"07","annual_impact_pp":0.8},{"label":"Health","coicop":"06","annual_impact_pp":0.2},{"label":"Restaurants & hotels","coicop":"11","annual_impact_pp":0.2},{"label":"Miscellaneous goods & services","coicop":"12","annual_impact_pp":-0.2},{"label":"Food & non-alcoholic beverages","coicop":"01","annual_impact_pp":0.1},{"label":"Alcoholic beverages & tobacco","coicop":"02","annual_impact_pp":0.1},{"label":"Housing, water, electricity, gas & fuels","coicop":"04","annual_impact_pp":0.1},{"label":"Communication","coicop":"08","annual_impact_pp":0.1},{"label":"Recreation & culture","coicop":"09","annual_impact_pp":0.1},{"label":"Other / personal care","coicop":"13","annual_impact_pp":-0.1},{"label":"Clothing & footwear","coicop":"03","annual_impact_pp":0},{"label":"Furnishings & household equipment","coicop":"05","annual_impact_pp":0},{"label":"Education","coicop":"10","annual_impact_pp":0}],"indicator":"Inflation drivers — annual impact by COICOP division (percentage points)","period_iso":"2026-05"},"meta":{"timestamp":"2026-06-15T20:40:29.231Z","request_id":"12359bdb-f3ed-4a0c-841e-798c2c621abd"},"status":"ok","message":"Åland inflation drivers 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/cpi/series":{"get":{"operationId":"get_v1_cpi_series","tags":["CPI"],"summary":"CPI monthly series","description":"","parameters":[{"name":"months","in":"query","required":false,"description":"Number of most recent months to return","schema":{"type":"string"},"example":"24"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"2025 = 100","count":17,"region":"Åland Islands","series":[{"index":100.37,"period":"2025M01","period_iso":"2025-01"},{"index":100.57,"period":"2025M02","period_iso":"2025-02","change_mom_pct":0.2},{"index":100.41,"period":"2025M03","period_iso":"2025-03","change_mom_pct":-0.2},{"index":100.2,"period":"2025M04","period_iso":"2025-04","change_mom_pct":-0.2},{"index":100,"period":"2025M05","period_iso":"2025-05","change_mom_pct":-0.2},{"index":99.92,"period":"2025M06","period_iso":"2025-06","change_mom_pct":-0.1},{"index":100.31,"period":"2025M07","period_iso":"2025-07","change_mom_pct":0.4},{"index":99.71,"period":"2025M08","period_iso":"2025-08","change_mom_pct":-0.6},{"index":99.52,"period":"2025M09","period_iso":"2025-09","change_mom_pct":-0.2},{"index":99.63,"period":"2025M10","period_iso":"2025-10","change_mom_pct":0.1},{"index":99.6,"period":"2025M11","period_iso":"2025-11","change_mom_pct":0},{"index":99.7,"period":"2025M12","period_iso":"2025-12","change_mom_pct":0.1},{"index":99.61,"period":"2026M01","period_iso":"2026-01","change_mom_pct":-0.1,"change_yoy_pct":-0.8},{"index":99.7,"period":"2026M02","period_iso":"2026-02","change_mom_pct":0.1,"change_yoy_pct":-0.9},{"index":100.36,"period":"2026M03","period_iso":"2026-03","change_mom_pct":0.7,"change_yoy_pct":0},{"index":101.35,"period":"2026M04","period_iso":"2026-04","change_mom_pct":1,"change_yoy_pct":1.1},{"index":101.73,"period":"2026M05","period_iso":"2026-05","change_mom_pct":0.4,"change_yoy_pct":1.7}],"source":"ÅSUB KO010","indicator":"CPI overall monthly series"},"meta":{"timestamp":"2026-06-15T20:40:29.312Z","request_id":"fe7cf36d-3b9a-4110-ad80-5e95cafdedf9"},"status":"ok","message":"Åland CPI 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":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"api":"Statistics Åland (ÅSUB) API","notes":"Live data from ÅSUB PxWeb (json-stat2). Index 2025=100; annual/monthly change and annual impact are published directly.","region":"Åland Islands (autonomous region of Finland, euro area)","source":"Statistics and Research Åland — ÅSUB PxWeb API (pxweb.asub.ax), table KO010","endpoints":["/v1/cpi","/v1/cpi/series","/v1/cpi/divisions","/v1/cpi/drivers","/v1/meta"],"documentation":"https://aland-stats-api.oanor.dev","primary_indicator":"Consumer Price Index (2025=100), overall + 13 COICOP divisions, with annual/monthly change and annual impact"},"meta":{"timestamp":"2026-06-15T20:40:29.384Z","request_id":"965287c8-0f07-466e-83a4-2c9330fead28"},"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":220,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1140,"monthly_call_quota":13400,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3410,"monthly_call_quota":64000,"rps_limit":12,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":8270,"monthly_call_quota":240000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/aland-stats-api"}