{"openapi":"3.1.0","info":{"title":"Finland Statistics API","version":"1.0.0","description":"Official Finnish statistics from Statistics Finland (Tilastokeskus / StatFin) as a clean, keyless JSON API. Get the latest Finnish consumer price index and inflation — index level (base 2025 = 100) and year-on-year change, monthly back to 1995 — pull any table in the vast StatFin PxWeb catalogue as a tidy time-series (prices, population, labour market, national accounts, energy, housing and hundreds more) without wrestling with the json-stat2 format, inspect a table's variables and value codes, and browse the database tree. A thin gateway over Statistics Finland's public StatFin PxWeb API: you supply a table path (relative to StatFin, e.g. khi/15b5.px) and optional dimension selection, we return the latest periods as plain period/value rows. Ideal for inflation trackers, Nordic macro research and economic dashboards.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/finland-stats-api","description":"oanor gateway"}],"tags":[{"name":"Inflation"},{"name":"Data"},{"name":"Catalog"},{"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":"Latest Finnish CPI and inflation","description":"","parameters":[{"name":"periods","in":"query","required":false,"description":"Number of recent months (1-60)","schema":{"type":"string"},"example":"12"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"2025 = 100","latest":{"month":"2026M05","index_value":102.14,"change_annual_pct":2.1},"series":[{"month":"2026M05","index_value":102.14,"change_annual_pct":2.1},{"month":"2026M04","index_value":101.68,"change_annual_pct":1.5},{"month":"2026M03","index_value":101.56,"change_annual_pct":1.3},{"month":"2026M02","index_value":100.83,"change_annual_pct":0.6},{"month":"2026M01","index_value":99.78,"change_annual_pct":-0.2},{"month":"2025M12","index_value":99.93,"change_annual_pct":0.2},{"month":"2025M11","index_value":99.71,"change_annual_pct":-0.1},{"month":"2025M10","index_value":99.95,"change_annual_pct":-0.2},{"month":"2025M09","index_value":100.11,"change_annual_pct":0.5},{"month":"2025M08","index_value":99.77,"change_annual_pct":0.5},{"month":"2025M07","index_value":100.01,"change_annual_pct":0.2},{"month":"2025M06","index_value":99.82,"change_annual_pct":0.2}],"source":"Statistics Finland (StatFin)","measure":"Consumer price index"},"meta":{"timestamp":"2026-06-15T11:14:40.460Z","request_id":"2aa8bc9c-fca2-415f-99a5-b2e72852e959"},"status":"ok","message":"CPI 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/series":{"get":{"operationId":"get_v1_series","tags":["Data"],"summary":"Any StatFin table as a time-series","description":"","parameters":[{"name":"path","in":"query","required":true,"description":"StatFin table path (relative, ends in .px)","schema":{"type":"string"},"example":"khi/15b5.px"},{"name":"select","in":"query","required":false,"description":"Dimension constraints \"Code:Value;Code:Value\"","schema":{"type":"string"},"example":"contentscode:ip_khi"},{"name":"periods","in":"query","required":false,"description":"Recent periods (1-120)","schema":{"type":"string"},"example":"12"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"path":"khi/15b5.px","title":"Consumer Price Index (2025=100) by Month, Commodity and Information","series":[{"value":102.14,"period":"2026M05"},{"value":101.68,"period":"2026M04"},{"value":101.56,"period":"2026M03"},{"value":100.83,"period":"2026M02"},{"value":99.78,"period":"2026M01"},{"value":99.93,"period":"2025M12"},{"value":99.71,"period":"2025M11"},{"value":99.95,"period":"2025M10"},{"value":100.11,"period":"2025M09"},{"value":99.77,"period":"2025M08"},{"value":100.01,"period":"2025M07"},{"value":99.82,"period":"2025M06"}],"constrained":{"contentscode":{"pos":0,"code":"ip_khi","label":"Point figure, CPI"},"coicop_46_20231201":{"pos":0,"code":"SSS","label":"0 Total"}},"time_dimension":"timeperiod_m"},"meta":{"timestamp":"2026-06-15T11:14:41.130Z","request_id":"8795812b-e12c-4cea-beec-da6b8bde1218"},"status":"ok","message":"Series 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/databases":{"get":{"operationId":"get_v1_databases","tags":["Catalog"],"summary":"Browse the database tree","description":"","parameters":[{"name":"path","in":"query","required":false,"description":"Sub-path to list (omit for root)","schema":{"type":"string"},"example":"khi"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"path":"khi","count":17,"items":[{"id":"11xc.px","text":"11xc -- Consumer Price Index (2015=100), yearly data, 2015-2025","type":"t"},{"id":"11xl.px","text":"11xl -- Cost-of-living index (1951:10=100), monthly data, 1951M01-2026M05","type":"t"},{"id":"11xm.px","text":"11xm -- Cost-of-living index (1951:10=100), annual data, 1951-2025","type":"t"},{"id":"11xn.px","text":"11xn -- Cost-of-living index (1938:8-1939:7=100), monthly data, 1939M01-2026M05","type":"t"},{"id":"11xp.px","text":"11xp -- Cost-of-living index (1938:8-1939:7=100), annual data, 1939-2025","type":"t"},{"id":"11xs.px","text":"11xs -- Consumer Price Indices, overall index, monthly data, 1972M01-2026M05","type":"t"},{"id":"11xt.px","text":"11xt -- Consumer Price Indices, overall index, yearly data, 1972-2025","type":"t"},{"id":"11xx.px","text":"11xx -- Average prices of liquid fuels, monthly data, 2002M01-2026M05","type":"t"},{"id":"11xy.px","text":"11xy -- Cost-of-living index (1914:1-6=100), annual data, 1860-2025","type":"t"},{"id":"11z1.px","text":"11z1 -- Average prices of liquid fuels, annual data, 2002-2025","type":"t"},{"id":"122p.px","text":"122p -- Annual changes of Consumer Price Index, monthly data, 1980M01-2026M05","type":"t"},{"id":"122q.px","text":"122q -- Annual changes of Consumer Price Index, yearly data, 1980-2025","type":"t"},{"id":"15b5.px","text":"15b5 -- Consumer Price Index (2025=100), monthly data, 1995M01-2026M05","type":"t"},{"id":"15b7.px","text":"15b7 -- Harmonised Index of Consumer Prices (HICP) and Harmonised Index of Consumer Prices at Constant Taxes (HICP-CT) (2025=100), monthly data, 1996M01-2026M05","type":"t"},{"id":"15b9.px","text":"15b9 -- Harmonised Index of Consumer Prices (HICP), preliminary data (2025=100), monthly data, 2026M01-2026M05","type":"t"},{"id":"15ba.px","text":"15ba -- Special Aggregates (2025=100), OECD, monthly data, 2025M01-2026M05","type":"t"},{"id":"15bc.px","text":"15bc -- The Weights of Harmonized Consumer Price Index and Consumer Price Index at Commodity Group Level, 2026","type":"t"}]},"meta":{"timestamp":"2026-06-15T11:14:41.350Z","request_id":"7c253818-ee39-4d9b-9264-a63d6f732d10"},"status":"ok","message":"Databases 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/table":{"get":{"operationId":"get_v1_table","tags":["Catalog"],"summary":"Table metadata (variables and value codes)","description":"","parameters":[{"name":"path","in":"query","required":true,"description":"StatFin table path (relative, ends in .px)","schema":{"type":"string"},"example":"khi/15b5.px"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"path":"khi/15b5.px","title":"Consumer Price Index (2025=100) by Month, Commodity and Information","variables":[{"code":"timeperiod_m","text":"Month","time":true,"n_values":377,"sample_values":[{"code":"1995M01","text":"1995M01"},{"code":"1995M02","text":"1995M02"},{"code":"1995M03","text":"1995M03"},{"code":"1995M04","text":"1995M04"},{"code":"1995M05","text":"1995M05"}]},{"code":"coicop_46_20231201","text":"Commodity","time":false,"n_values":390,"sample_values":[{"code":"SSS","text":"0 Total"},{"code":"01","text":"01 FOOD AND NON-ALCOHOLIC BEVERAGES"},{"code":"011","text":"01.1 Food"},{"code":"0111","text":"01.1.1 Cereals and cereal products (ND)"},{"code":"01111","text":"01.1.1.1 Cereals (ND)"}]},{"code":"contentscode","text":"Information","time":false,"n_values":5,"sample_values":[{"code":"ip_khi","text":"Point figure, CPI"},{"code":"vm_khi","text":"Annual change (%), CPI"},{"code":"km_khi","text":"Monthly change (%), CPI"},{"code":"vv_khi","text":"Annual impact (%-units), CPI"},{"code":"kv_khi","text":"Monthly impact (%-units), CPI"}]}]},"meta":{"timestamp":"2026-06-15T11:14:41.500Z","request_id":"3e62ad07-aee2-4bdc-89dd-23bab3797dd0"},"status":"ok","message":"Table metadata 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":"For /v1/series and /v1/table, path is relative to StatFin, e.g. khi/15b5.px","source":"Statistics Finland (Tilastokeskus / StatFin)","upstream":"https://pxdata.stat.fi/PxWeb/api/v1/en/StatFin","cpi_table":"khi/15b5.px","endpoints":["/v1/cpi","/v1/series","/v1/table","/v1/databases","/v1/meta"],"description":"Keyless gateway over Statistics Finland's StatFin PxWeb API. /v1/cpi gives the latest Finnish consumer price index and annual inflation; /v1/series pulls any StatFin table as a clean time-series; /v1/table and /v1/databases discover the catalog.","documentation":"https://finland-stats-api.oanor.dev"},"meta":{"timestamp":"2026-06-15T11:14:41.596Z","request_id":"2c06dba0-97ea-43a6-81f4-42b6ea023f44"},"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":2600,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1240,"monthly_call_quota":51500,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3140,"monthly_call_quota":204000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6950,"monthly_call_quota":838000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/finland-stats-api"}