{"openapi":"3.1.0","info":{"title":"Faroe Islands Statistics API","version":"1.0.0","description":"Official Faroese statistics from Statistics Faroe Islands (Hagstova Føroya) as a clean, keyless JSON API. Get the latest Faroese consumer price index and inflation — the quarterly index with both the annual and period rate of change — pull any table in the Hagstova PxWeb catalogue as a tidy time-series (prices, population, labour and wages, trade, business, transport and more), inspect a table's variables and value codes, and browse the subject tree. A thin gateway over the Statistics Faroe Islands PxWeb API: you supply a table path (relative to the H2 database, e.g. IP/IP02/pris_alt.px) with optional dimension selection, we return tidy period/value observations. Ideal for inflation trackers and Nordic / North-Atlantic macro research.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/faroe-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 Faroese CPI and inflation","description":"","parameters":[{"name":"periods","in":"query","required":false,"description":"Number of recent quarters (1-80)","schema":{"type":"string"},"example":"8"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"table":"IP/IP02/pris_alt.px","latest":{"year":2026,"period":"Q1","index_value":144.55,"period_label":"February","change_annual_pct":-0.2,"change_period_pct":0.1},"series":[{"year":2026,"period":"Q1","index_value":144.55,"period_label":"February","change_annual_pct":-0.2,"change_period_pct":0.1},{"year":2025,"period":"Q4","index_value":144.43,"period_label":"November","change_annual_pct":0.7,"change_period_pct":-0.4},{"year":2025,"period":"Q3","index_value":144.94,"period_label":"August","change_annual_pct":1.1,"change_period_pct":0.2},{"year":2025,"period":"Q2","index_value":144.63,"period_label":"May","change_annual_pct":0.7,"change_period_pct":-0.1},{"year":2025,"period":"Q1","index_value":144.8,"period_label":"February","change_annual_pct":1.3,"change_period_pct":0.9},{"year":2024,"period":"Q4","index_value":143.48,"period_label":"November","change_annual_pct":0.8,"change_period_pct":0.1},{"year":2024,"period":"Q3","index_value":143.34,"period_label":"August","change_annual_pct":1.7,"change_period_pct":-0.2},{"year":2024,"period":"Q2","index_value":143.66,"period_label":"May","change_annual_pct":3,"change_period_pct":0.5}],"source":"Statistics Faroe Islands (Hagstova Føroya)","measure":"Consumer price index","frequency":"quarterly (Q1=Feb, Q2=May, Q3=Aug, Q4=Nov)","commodity_group":"Consumer price index (total)"},"meta":{"timestamp":"2026-06-15T20:41:08.430Z","request_id":"8bb76f85-ba21-40d9-83ea-f69550d69ffe"},"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 Hagstova PxWeb table as a time-series","description":"","parameters":[{"name":"path","in":"query","required":true,"description":"Table path relative to H2 (ends in .px)","schema":{"type":"string"},"example":"IP/IP02/pris_alt.px"},{"name":"select","in":"query","required":false,"description":"Dimension constraints \"Code:Value;Code:Value\"","schema":{"type":"string"},"example":"measure:INDEX"},{"name":"periods","in":"query","required":false,"description":"Recent periods (1-240)","schema":{"type":"string"},"example":"12"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"path":"IP/IP02/pris_alt.px","count":12,"title":"Consumer price index by measure, year and period","series":[{"value":144.55,"period":"2026","period_label":"2026"},{"value":144.8,"period":"2025","period_label":"2025"},{"value":142.96,"period":"2024","period_label":"2024"},{"value":139.34,"period":"2023","period_label":"2023"},{"value":128.64,"period":"2022","period_label":"2022"},{"value":123.21,"period":"2021","period_label":"2021"},{"value":121.91,"period":"2020","period_label":"2020"},{"value":120,"period":"2019","period_label":"2019"},{"value":118.6,"period":"2018","period_label":"2018"},{"value":117.52,"period":"2017","period_label":"2017"},{"value":116.09,"period":"2016","period_label":"2016"},{"value":117.22,"period":"2015","period_label":"2015"}],"constrained":{"period":{"pos":0,"code":"Q1","label":"February"},"measure":{"pos":0,"code":"INDEX","label":"Index"}},"time_dimension":"year"},"meta":{"timestamp":"2026-06-15T20:41:08.640Z","request_id":"fd5d97f8-e1c5-4e19-9069-d164612cfbbd"},"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/catalog":{"get":{"operationId":"get_v1_catalog","tags":["Catalog"],"summary":"Browse the subject tree","description":"","parameters":[{"name":"path","in":"query","required":false,"description":"Sub-path to list (omit for root)","schema":{"type":"string"},"example":"IP"},{"name":"limit","in":"query","required":false,"description":"Max items (1-400)","schema":{"type":"string"},"example":"100"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"path":"IP","count":4,"items":[{"id":"IP01","text":"Income distibution and risk of poverty\n","type":"folder"},{"id":"IP02","text":"Consumer price index\n","type":"folder"},{"id":"IP04","text":"Residential properties\n","type":"folder"},{"id":"endad","text":"Discontinued tables\n","type":"folder"}]},"meta":{"timestamp":"2026-06-15T20:41:08.879Z","request_id":"cc463c9f-0429-4bbc-9167-8f18ac4700d7"},"status":"ok","message":"Catalog 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":"Table path relative to H2","schema":{"type":"string"},"example":"IP/IP02/pris_alt.px"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"path":"IP/IP02/pris_alt.px","title":"IP02005 Consumer price index, by commodity groups and period (2001-2026)","variables":[{"code":"measure","text":"measure","n_values":3,"sample_values":[{"code":"INDEX","text":"Index"},{"code":"CHYEAR","text":"Annual rate of change (per cent)"},{"code":"CHTIME","text":"Period rate of change (per cent)"}]},{"code":"commodity groups","text":"commodity groups","n_values":117,"sample_values":[{"code":"CPI","text":"Consumer price index"},{"code":"0100","text":"01 Food and non-alcoholic beverages"},{"code":"0110","text":"01.1 Food"},{"code":"0111","text":"01.1.1 bread and cereals"},{"code":"0112","text":"01.1.2 meat"},{"code":"0113","text":"01.1.3 fish"}]},{"code":"year","text":"year","n_values":26,"sample_values":[{"code":"2001","text":"2001"},{"code":"2002","text":"2002"},{"code":"2003","text":"2003"},{"code":"2004","text":"2004"},{"code":"2005","text":"2005"},{"code":"2006","text":"2006"}]},{"code":"period","text":"period","n_values":4,"sample_values":[{"code":"Q1","text":"February"},{"code":"Q2","text":"May"},{"code":"Q3","text":"August"},{"code":"Q4","text":"November"}]}]},"meta":{"timestamp":"2026-06-15T20:41:09.014Z","request_id":"f4782178-2f2b-4f49-ac7d-8d2b2321ece8"},"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":"path is relative to the H2 database, e.g. IP/IP02/pris_alt.px (consumer prices).","source":"Statistics Faroe Islands (Hagstova Føroya)","upstream":"https://statbank.hagstova.fo/api/v1/en/H2","cpi_table":"IP/IP02/pris_alt.px","endpoints":["/v1/cpi","/v1/series","/v1/table","/v1/catalog","/v1/meta"],"description":"Keyless gateway over the Statistics Faroe Islands PxWeb API. /v1/cpi gives the latest Faroese consumer price index and inflation (index + annual + period change, quarterly); /v1/series pulls any table as a clean time-series; /v1/table inspects a table's variables; /v1/catalog browses the subject tree.","documentation":"https://faroe-stats-api.oanor.dev"},"meta":{"timestamp":"2026-06-15T20:41:09.118Z","request_id":"8e67873b-7d10-472e-9c58-554022de84d5"},"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":2250,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1060,"monthly_call_quota":46500,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2740,"monthly_call_quota":186000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6280,"monthly_call_quota":804000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/faroe-stats-api"}