{"openapi":"3.1.0","info":{"title":"Iceland Statistics API","version":"1.0.0","description":"Official Icelandic statistics from Statistics Iceland (Hagstofa Íslands) as a clean, keyless JSON API. Get the latest Icelandic consumer price index and inflation — index level, month-on-month and year-on-year change for both the headline CPI and CPI-less-housing (base 1988=100) — pull any table in the Hagstofa PxWeb catalogue as a tidy time-series (economy, industries, population, society, environment) 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 Iceland's public PxWeb API: you supply a table path and optional dimension selection, we return the latest periods as plain period/value rows. Ideal for inflation trackers, economic dashboards and Nordic macro research.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/iceland-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 Icelandic CPI and inflation","description":"","parameters":[{"name":"index","in":"query","required":false,"description":"CPI or CPILH (less housing)","schema":{"type":"string"},"example":"CPI"},{"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":"1988=100","latest":{"month":"2026M05","index_value":684.3,"change_annual_pct":5.1,"change_monthly_pct":0.07},"series":[{"month":"2026M05","index_value":684.3,"change_annual_pct":5.1,"change_monthly_pct":0.07},{"month":"2026M04","index_value":683.8,"change_annual_pct":5.2,"change_monthly_pct":0.81},{"month":"2026M03","index_value":678.3,"change_annual_pct":5.4,"change_monthly_pct":0.55},{"month":"2026M02","index_value":674.6,"change_annual_pct":5.2,"change_monthly_pct":0.94},{"month":"2026M01","index_value":668.3,"change_annual_pct":5.2,"change_monthly_pct":0.38},{"month":"2025M12","index_value":665.8,"change_annual_pct":4.5,"change_monthly_pct":1.15},{"month":"2025M11","index_value":658.2,"change_annual_pct":3.7,"change_monthly_pct":-0.48},{"month":"2025M10","index_value":661.4,"change_annual_pct":4.3,"change_monthly_pct":0.47},{"month":"2025M09","index_value":658.3,"change_annual_pct":4.1,"change_monthly_pct":0.11},{"month":"2025M08","index_value":657.6,"change_annual_pct":3.8,"change_monthly_pct":-0.15},{"month":"2025M07","index_value":658.6,"change_annual_pct":4,"change_monthly_pct":0.32},{"month":"2025M06","index_value":656.5,"change_annual_pct":4.2,"change_monthly_pct":0.84}],"measure":"CPI","measure_label":"Consumer price index"},"meta":{"timestamp":"2026-06-15T11:14:45.718Z","request_id":"84a08326-df67-4964-8248-07183f642e3b"},"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 PxWeb table as a time-series","description":"","parameters":[{"name":"path","in":"query","required":true,"description":"PxWeb table path (ends in .px)","schema":{"type":"string"},"example":"Efnahagur/visitolur/1_vnv/1_vnv/VIS01000.px"},{"name":"select","in":"query","required":false,"description":"Dimension constraints \"Code:Value;Code:Value\"","schema":{"type":"string"},"example":"Index:CPI"},{"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":"Efnahagur/visitolur/1_vnv/1_vnv/VIS01000.px","title":"Consumer price index by Month, Index and Item","series":[{"value":684.3,"period":"2026M05"},{"value":683.8,"period":"2026M04"},{"value":678.3,"period":"2026M03"},{"value":674.6,"period":"2026M02"},{"value":668.3,"period":"2026M01"},{"value":665.8,"period":"2025M12"},{"value":658.2,"period":"2025M11"},{"value":661.4,"period":"2025M10"},{"value":658.3,"period":"2025M09"},{"value":657.6,"period":"2025M08"},{"value":658.6,"period":"2025M07"},{"value":656.5,"period":"2025M06"}],"constrained":{"Item":{"pos":0,"code":"index","label":"Index"},"Index":{"pos":0,"code":"CPI","label":"Consumer price index"}},"time_dimension":"Month"},"meta":{"timestamp":"2026-06-15T11:14:46.124Z","request_id":"bb37dc4f-c3e9-4dd0-b006-2cac6afe7342"},"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":"Efnahagur"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"path":"Efnahagur","count":6,"items":[{"id":"fjaropinber","text":"Public finance","type":"l"},{"id":"thjodhagsreikningar","text":"National accounts","type":"l"},{"id":"thjodhagsspa","text":"Economic forecast","type":"l"},{"id":"utanrikisverslun","text":"External trade","type":"l"},{"id":"vinnumagnogframleidni","text":"Employment and labour productivity","type":"l"},{"id":"visitolur","text":"Prices and consumption","type":"l"}]},"meta":{"timestamp":"2026-06-15T11:14:46.300Z","request_id":"6ad108e9-3f37-484c-89c5-065fbc27b417"},"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":"PxWeb table path (ends in .px)","schema":{"type":"string"},"example":"Efnahagur/visitolur/1_vnv/1_vnv/VIS01000.px"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"path":"Efnahagur/visitolur/1_vnv/1_vnv/VIS01000.px","title":"Consumer price index and changes, base 1988=100","variables":[{"code":"Month","text":"Month","time":true,"n_values":457,"sample_values":[{"code":"2026M01","text":"2026M01"},{"code":"2026M02","text":"2026M02"},{"code":"2026M03","text":"2026M03"},{"code":"2026M04","text":"2026M04"},{"code":"2026M05","text":"2026M05"}]},{"code":"Index","text":"Index","time":false,"n_values":2,"sample_values":[{"code":"CPI","text":"Consumer price index"},{"code":"CPILH","text":"Consumer price index less housing cost"}]},{"code":"Item","text":"Item","time":false,"n_values":6,"sample_values":[{"code":"change_M","text":"Monthly change, %"},{"code":"change_A","text":"Annual change, %"},{"code":"A_rate_M","text":"Annualized rate, latest month, %"},{"code":"A_rate_3M","text":"Annualized rate, 3 month, %"},{"code":"A_rate_6M","text":"Annualized rate,  6 month, %"}]}]},"meta":{"timestamp":"2026-06-15T11:14:46.479Z","request_id":"25d64e10-72ce-41b1-94cb-ba728fe55a5a"},"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":{"source":"Statistics Iceland (Hagstofa Íslands)","upstream":"https://px.hagstofa.is/pxen/api/v1/en","cpi_table":"Efnahagur/visitolur/1_vnv/1_vnv/VIS01000.px","databases":["Atvinnuvegir (industries)","Efnahagur (economy)","Ibuar (population)","Samfelag (society)","Umhverfi (environment)"],"endpoints":["/v1/cpi","/v1/series","/v1/table","/v1/databases","/v1/meta"],"description":"Keyless gateway over Statistics Iceland's PxWeb API. /v1/cpi gives the latest Icelandic consumer price index and inflation; /v1/series pulls any PxWeb table as a clean time-series; /v1/table and /v1/databases discover the catalog.","documentation":"https://iceland-stats-api.oanor.dev"},"meta":{"timestamp":"2026-06-15T11:14:46.531Z","request_id":"dcc89182-a503-42fc-92ab-370d76ec28a2"},"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":2400,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1190,"monthly_call_quota":49600,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2990,"monthly_call_quota":198500,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6750,"monthly_call_quota":817000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/iceland-stats-api"}