{"openapi":"3.1.0","info":{"title":"Kosovo Statistics API","version":"1.0.0","description":"Official Kosovo economic statistics straight from the Kosovo Agency of Statistics (ASK) via its ASKdata open-data service — no key, read live. The cpi endpoint returns the headline Harmonised Index of Consumer Prices (HICP, all items, base 2015=100) for the latest month with the index level plus month-on-month and year-on-year inflation, computed from the official series. The cpi/series endpoint returns the historical monthly HICP index and year-on-year rate over the last N months, ready to chart. The cpi/groups endpoint breaks the latest HICP down across all twelve COICOP main groups (food, housing, transport and so on) with index and annual change for each. The cpi/annual endpoint gives the annual-average HICP and average inflation for every year since 2002. The meta endpoint documents the source. Live data from ASKdata PxWeb, lightly cached. Live. 5 endpoints. This serves Kosovo national price statistics; for the euro exchange rate use an FX API (Kosovo uses the euro).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/kosovo-stats-api","description":"oanor gateway"}],"tags":[{"name":"Inflation"},{"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":"Kosovo HICP (latest month): index, MoM and YoY","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"2015 = 100","index":142.6,"period":"2026M03","source":"Kosovo Agency of Statistics (ASK, table cpi08)","country":"Kosovo","indicator":"Harmonised Index of Consumer Prices (HICP, all items)","period_iso":"2026-03","change_mom_pct":1.42,"change_yoy_pct":6.66},"meta":{"timestamp":"2026-06-15T20:40:34.338Z","request_id":"a91ec759-8aae-4fc4-acca-3ae0e3f3d9d9"},"status":"ok","message":"Kosovo HICP 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/annual":{"get":{"operationId":"get_v1_cpi_annual","tags":["Inflation"],"summary":"Annual-average HICP + inflation since 2002","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"2015 = 100","count":25,"years":[{"year":"2002","months":8,"average_index":78.12},{"year":"2003","months":12,"average_index":79.05,"annual_avg_change_pct":1.19},{"year":"2004","months":12,"average_index":78.21,"annual_avg_change_pct":-1.06},{"year":"2005","months":12,"average_index":77.13,"annual_avg_change_pct":-1.38},{"year":"2006","months":12,"average_index":77.62,"annual_avg_change_pct":0.64},{"year":"2007","months":12,"average_index":80.98,"annual_avg_change_pct":4.33},{"year":"2008","months":12,"average_index":88.55,"annual_avg_change_pct":9.35},{"year":"2009","months":12,"average_index":86.41,"annual_avg_change_pct":-2.42},{"year":"2010","months":12,"average_index":89.43,"annual_avg_change_pct":3.49},{"year":"2011","months":12,"average_index":95.98,"annual_avg_change_pct":7.32},{"year":"2012","months":12,"average_index":98.37,"annual_avg_change_pct":2.49},{"year":"2013","months":12,"average_index":100.11,"annual_avg_change_pct":1.77},{"year":"2014","months":12,"average_index":100.53,"annual_avg_change_pct":0.42},{"year":"2015","months":12,"average_index":99.99,"annual_avg_change_pct":-0.54},{"year":"2016","months":12,"average_index":100.29,"annual_avg_change_pct":0.3},{"year":"2017","months":12,"average_index":101.78,"annual_avg_change_pct":1.49},{"year":"2018","months":12,"average_index":102.85,"annual_avg_change_pct":1.05},{"year":"2019","months":12,"average_index":105.59,"annual_avg_change_pct":2.66},{"year":"2020","months":12,"average_index":105.8,"annual_avg_change_pct":0.2},{"year":"2021","months":12,"average_index":109.34,"annual_avg_change_pct":3.35},{"year":"2022","months":12,"average_index":122.01,"annual_avg_change_pct":11.59},{"year":"2023","months":12,"average_index":128.05,"annual_avg_change_pct":4.95},{"year":"2024","months":12,"average_index":130.11,"annual_avg_change_pct":1.61},{"year":"2025","months":12,"average_index":135.13,"annual_avg_change_pct":3.86},{"year":"2026","months":3,"average_index":141,"annual_avg_change_pct":4.34}],"source":"ASK cpi08","country":"Kosovo","indicator":"HICP annual average + inflation"},"meta":{"timestamp":"2026-06-15T20:40:34.431Z","request_id":"859aeaa5-5345-488d-bc4d-7e8b17bc3abb"},"status":"ok","message":"Kosovo HICP annual averages 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/groups":{"get":{"operationId":"get_v1_cpi_groups","tags":["Inflation"],"summary":"Latest HICP across all 12 COICOP groups","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"2015 = 100","count":12,"groups":[{"group":"1","index":164.2,"label":"01 Food & non-alcoholic beverages","change_yoy_pct":6.49},{"group":"2","index":151.2,"label":"02 Alcoholic beverages & tobacco","change_yoy_pct":4.06},{"group":"3","index":113.8,"label":"03 Clothing & footwear","change_yoy_pct":1.7},{"group":"4","index":143.4,"label":"04 Housing, water, electricity, gas & fuels","change_yoy_pct":15.18},{"group":"5","index":128.9,"label":"05 Furnishings & household equipment","change_yoy_pct":2.96},{"group":"6","index":126.4,"label":"06 Health","change_yoy_pct":4.64},{"group":"7","index":130.9,"label":"07 Transport","change_yoy_pct":10.56},{"group":"8","index":111.7,"label":"08 Communication","change_yoy_pct":-0.53},{"group":"9","index":109.7,"label":"09 Recreation & culture","change_yoy_pct":1.57},{"group":"10","index":107,"label":"10 Education","change_yoy_pct":-0.28},{"group":"11","index":145.9,"label":"11 Restaurants & hotels","change_yoy_pct":6.73},{"group":"12","index":126.7,"label":"12 Miscellaneous goods & services","change_yoy_pct":3.18}],"period":"2026M03","source":"ASK cpi08","country":"Kosovo","indicator":"HICP by COICOP main group","period_iso":"2026-03"},"meta":{"timestamp":"2026-06-15T20:40:34.494Z","request_id":"04e35708-f619-423c-b634-9b30e777b7f7"},"status":"ok","message":"Kosovo HICP by group 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":["Inflation"],"summary":"Historical HICP index + YoY series","description":"","parameters":[{"name":"months","in":"query","required":false,"description":"Number of recent months (default 24, max 240)","schema":{"type":"string"},"example":"24"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"2015 = 100","count":24,"series":[{"index":130.1,"period":"2024M04","period_iso":"2024-04","change_yoy_pct":2.44},{"index":129.6,"period":"2024M05","period_iso":"2024-05","change_yoy_pct":2.37},{"index":129.6,"period":"2024M06","period_iso":"2024-06","change_yoy_pct":2.37},{"index":129.9,"period":"2024M07","period_iso":"2024-07","change_yoy_pct":2.12},{"index":130.2,"period":"2024M08","period_iso":"2024-08","change_yoy_pct":1.4},{"index":129.8,"period":"2024M09","period_iso":"2024-09","change_yoy_pct":0.23},{"index":130,"period":"2024M10","period_iso":"2024-10","change_yoy_pct":0.39},{"index":130.3,"period":"2024M11","period_iso":"2024-11","change_yoy_pct":0.7},{"index":131.2,"period":"2024M12","period_iso":"2024-12","change_yoy_pct":1.08},{"index":132.2,"period":"2025M01","period_iso":"2025-01","change_yoy_pct":1.54},{"index":132.6,"period":"2025M02","period_iso":"2025-02","change_yoy_pct":1.69},{"index":133.7,"period":"2025M03","period_iso":"2025-03","change_yoy_pct":2.85},{"index":134,"period":"2025M04","period_iso":"2025-04","change_yoy_pct":3},{"index":134.3,"period":"2025M05","period_iso":"2025-05","change_yoy_pct":3.63},{"index":135.2,"period":"2025M06","period_iso":"2025-06","change_yoy_pct":4.32},{"index":135.5,"period":"2025M07","period_iso":"2025-07","change_yoy_pct":4.31},{"index":136.2,"period":"2025M08","period_iso":"2025-08","change_yoy_pct":4.61},{"index":135.8,"period":"2025M09","period_iso":"2025-09","change_yoy_pct":4.62},{"index":136.7,"period":"2025M10","period_iso":"2025-10","change_yoy_pct":5.15},{"index":137.2,"period":"2025M11","period_iso":"2025-11","change_yoy_pct":5.3},{"index":138.2,"period":"2025M12","period_iso":"2025-12","change_yoy_pct":5.34},{"index":139.8,"period":"2026M01","period_iso":"2026-01","change_yoy_pct":5.75},{"index":140.6,"period":"2026M02","period_iso":"2026-02","change_yoy_pct":6.03},{"index":142.6,"period":"2026M03","period_iso":"2026-03","change_yoy_pct":6.66}],"source":"ASK cpi08","country":"Kosovo","indicator":"HICP monthly series"},"meta":{"timestamp":"2026-06-15T20:40:34.572Z","request_id":"70cfd418-73f7-47ce-837b-baf15bbc65ce"},"status":"ok","message":"Kosovo HICP 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":"API metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"api":"Statistics Kosovo (ASK) API","notes":"Live data from ASKdata PxWeb (json-stat2); year-on-year and month-on-month computed from the HICP index series.","source":"Kosovo Agency of Statistics — ASKdata PxWeb API (askdata.rks-gov.net)","country":"Kosovo","endpoints":["/v1/cpi","/v1/cpi/series","/v1/cpi/groups","/v1/cpi/annual","/v1/meta"],"documentation":"https://kosovo-stats-api.oanor.dev","primary_indicator":"HICP — Harmonised Index of Consumer Prices (table cpi08, 2015=100, total + 12 COICOP groups)"},"meta":{"timestamp":"2026-06-15T20:40:34.659Z","request_id":"035ccb8e-a91c-4451-ba68-07c2249c0c3f"},"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":260,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1170,"monthly_call_quota":18300,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3040,"monthly_call_quota":93500,"rps_limit":22,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6730,"monthly_call_quota":431000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/kosovo-stats-api"}