{"openapi":"3.1.0","info":{"title":"Slovenia Statistics API","version":"1.0.0","description":"Official Slovenian statistics from the Statistical Office of the Republic of Slovenia (SURS) as a clean, keyless JSON API. Get the latest Slovenian consumer price index and inflation — the monthly index (2025 average = 100) with both the year-on-year and month-on-month change derived for you — pull any of the 4,700+ matrices in the SURS SiStat catalogue as a tidy time-series (economy, prices, population, labour market, trade and far more), inspect a matrix's variables and value codes, and search the catalogue. A thin gateway over the SURS PxWeb API: you supply a matrix id (e.g. 0400608S) with optional dimension selection, we return tidy period/value observations. Ideal for inflation trackers, Eurozone and Balkan macro research and economic dashboards.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/slovenia-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 Slovenian CPI and inflation","description":"","parameters":[{"name":"periods","in":"query","required":false,"description":"Number of recent months (1-120)","schema":{"type":"string"},"example":"12"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"2025 average = 100","table":"0400608S.px","latest":{"period":"2026M05","index_value":103.45,"change_annual_pct":3.6,"change_monthly_pct":0.5},"series":[{"period":"2026M05","index_value":103.45,"change_annual_pct":3.6,"change_monthly_pct":0.5},{"period":"2026M04","index_value":102.93,"change_annual_pct":3.1,"change_monthly_pct":1.9},{"period":"2026M03","index_value":101.01,"change_annual_pct":2.5,"change_monthly_pct":0.2},{"period":"2026M02","index_value":100.84,"change_annual_pct":2.9,"change_monthly_pct":0.6},{"period":"2026M01","index_value":100.23,"change_annual_pct":2.6,"change_monthly_pct":-0.5},{"period":"2025M12","index_value":100.77,"change_annual_pct":2.7,"change_monthly_pct":0},{"period":"2025M11","index_value":100.72,"change_annual_pct":2.3,"change_monthly_pct":0},{"period":"2025M10","index_value":100.75,"change_annual_pct":3.1,"change_monthly_pct":0},{"period":"2025M09","index_value":100.79,"change_annual_pct":2.6,"change_monthly_pct":-0.4},{"period":"2025M08","index_value":101.19,"change_annual_pct":3,"change_monthly_pct":0},{"period":"2025M07","index_value":101.2,"change_annual_pct":2.8,"change_monthly_pct":0.5},{"period":"2025M06","index_value":100.68,"change_annual_pct":2.2,"change_monthly_pct":0.8}],"source":"Statistical Office of the Republic of Slovenia (SURS)","measure":"Consumer price index","commodity_group":"Total"},"meta":{"timestamp":"2026-06-15T20:41:14.672Z","request_id":"8ef3f4c9-f1c6-48d0-90b7-ae469f84bd7a"},"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 SURS matrix as a time-series","description":"","parameters":[{"name":"table","in":"query","required":true,"description":"SURS matrix id","schema":{"type":"string"},"example":"0400608S"},{"name":"select","in":"query","required":false,"description":"Dimension constraints \"Code:Value;Code:Value\"","schema":{"type":"string"},"example":"MERITVE:33"},{"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":{"count":12,"table":"0400608S.px","title":"Consumer price indices (ECOICOP ver. 2) by CONSUMER PRODUCT, MONTH and MEASURES","series":[{"value":103.45,"period":"2026M05","period_label":"2026M05"},{"value":102.93,"period":"2026M04","period_label":"2026M04"},{"value":101.01,"period":"2026M03","period_label":"2026M03"},{"value":100.84,"period":"2026M02","period_label":"2026M02"},{"value":100.23,"period":"2026M01","period_label":"2026M01"},{"value":100.77,"period":"2025M12","period_label":"2025M12"},{"value":100.72,"period":"2025M11","period_label":"2025M11"},{"value":100.75,"period":"2025M10","period_label":"2025M10"},{"value":100.79,"period":"2025M09","period_label":"2025M09"},{"value":101.19,"period":"2025M08","period_label":"2025M08"},{"value":101.2,"period":"2025M07","period_label":"2025M07"},{"value":100.68,"period":"2025M06","period_label":"2025M06"}],"constrained":{"MERITVE":{"pos":0,"code":"33","label":"Index (month / average of the year 2025)"},"ŽIVLJENJSKA POTREBŠČINA":{"pos":0,"code":"TOT","label":"TOTAL"}},"time_dimension":"MESEC"},"meta":{"timestamp":"2026-06-15T20:41:15.655Z","request_id":"d60e9247-a1a1-4f0c-a187-830729e00e33"},"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":"Search the SiStat matrix catalogue","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Search term (title or matrix id)","schema":{"type":"string"},"example":"consumer price"},{"name":"limit","in":"query","required":false,"description":"Max results (1-200)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"query":"consumer price","total":4765,"tables":[{"id":"0400600S","text":"Consumer price indices by ECOICOP ver. 1 classification, Slovenia, 2000M01 - 2025M12","updated":"2026-02-13T09:48:42"},{"id":"0400601S","text":"Consumer price indices by COICOP/HICP by groups and subgroups, Slovenia, 2000M01 - 2016M12","updated":"2022-01-20T11:52:08"},{"id":"0400606S","text":"Harmonised index of consumer prices by ECOICOP ver. 1 classification, Slovenia, 2001M01 - 2025M12","updated":"2026-02-13T09:48:28"},{"id":"0400607S","text":"Harmonised index of consumer prices at constant tax rates by ECOICOP ver. 1 classification, Slovenia, 2003M01 - 2025M12","updated":"2026-02-13T09:44:04"},{"id":"0400608S","text":"Consumer price indices (ECOICOP ver. 2), Slovenia, monthly","updated":"2026-06-02T13:20:27"},{"id":"0400609S","text":"Harmonised index of consumer prices (ECOICOP ver. 2), Slovenia, monthly","updated":"2026-06-02T13:09:23"},{"id":"0400610S","text":"Harmonised index of consumer prices at constant tax rates (ECOICOP ver. 2), Slovenia, monthly","updated":"2026-06-02T13:12:37"},{"id":"0400611S","text":"Consumer price indices and growth rates of prices by main groups, Slovenia, annually","updated":"2026-02-25T13:42:33"},{"id":"0811603S","text":"Consumer survey, past trend of consumer prices perceptions, Slovenia, monthly","updated":"2026-05-19T11:10:03"},{"id":"0811604S","text":"Consumer survey, future trend of consumer prices expectations, Slovenia, monthly","updated":"2026-05-19T11:10:06"}]},"meta":{"timestamp":"2026-06-15T20:41:16.351Z","request_id":"1a97bd31-c4b5-4260-8496-1db3be2084ad"},"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":"Matrix metadata (variables and value codes)","description":"","parameters":[{"name":"table","in":"query","required":true,"description":"SURS matrix id","schema":{"type":"string"},"example":"0400608S"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"table":"0400608S.px","title":"Consumer price indices (ECOICOP ver. 2) by CONSUMER PRODUCT, MONTH and MEASURES","variables":[{"code":"ŽIVLJENJSKA POTREBŠČINA","text":"CONSUMER PRODUCT","n_values":435,"sample_values":[{"code":"TOT","text":"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"},{"code":"01111","text":"01.1.1.1 Cereals"},{"code":"01112","text":"01.1.1.2 Flour of cereals"}]},{"code":"MESEC","text":"MONTH","n_values":317,"sample_values":[{"code":"2000M01","text":"2000M01"},{"code":"2000M02","text":"2000M02"},{"code":"2000M03","text":"2000M03"},{"code":"2000M04","text":"2000M04"},{"code":"2000M05","text":"2000M05"},{"code":"2000M06","text":"2000M06"}]},{"code":"MERITVE","text":"MEASURES","n_values":9,"sample_values":[{"code":"0","text":"Structure of consumer products (%)"},{"code":"3","text":"Index (month / December of the previous year)"},{"code":"1","text":"Index (month / previous month)"},{"code":"2","text":"Index (month / same month of the previous year)"},{"code":"6","text":"Index (average in year / average of the same months of the previous year)"},{"code":"7","text":"Index (average in year / December of the previous year)"}]}]},"meta":{"timestamp":"2026-06-15T20:41:16.477Z","request_id":"ff389d6f-8b61-42d1-adc3-04f8d2d513a8"},"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":"table takes a SURS matrix id, e.g. 0400608S (consumer prices).","source":"Statistical Office of the Republic of Slovenia (SURS)","upstream":"https://pxweb.stat.si/SiStatData/api/v1/en/Data","cpi_table":"0400608S.px","endpoints":["/v1/cpi","/v1/series","/v1/table","/v1/catalog","/v1/meta"],"description":"Keyless gateway over the SURS SiStat PxWeb API. /v1/cpi gives the latest Slovenian consumer price index and inflation (index + year-on-year + monthly change); /v1/series pulls any matrix as a clean time-series; /v1/table inspects a matrix's variables; /v1/catalog searches the 4,700+ matrix catalogue.","documentation":"https://slovenia-stats-api.oanor.dev"},"meta":{"timestamp":"2026-06-15T20:41:16.570Z","request_id":"07531152-36fc-41f1-87b8-cf990a33ad48"},"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":2650,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1170,"monthly_call_quota":49500,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2960,"monthly_call_quota":192000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6590,"monthly_call_quota":821000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/slovenia-stats-api"}