{"openapi":"3.1.0","info":{"title":"Ireland Statistics API","version":"1.0.0","description":"Official Irish statistics from the Central Statistics Office Ireland (CSO) as a clean, keyless JSON API. Get the latest Irish consumer price index and inflation — index level (base December 2023 = 100), month-on-month and year-on-year change for the all-items index — pull any matrix in the CSO PxStat catalogue as a tidy time-series (prices, population, labour, national accounts, agriculture, trade and thousands more) without parsing the JSON-stat format, inspect a matrix's dimensions and value codes, and search the catalogue. A thin gateway over the CSO PxStat (JSON-stat 2.0) API: you supply a matrix code (e.g. CPM01) and how many recent periods you want, we return tidy period/value observations. Ideal for inflation trackers, Irish and Eurozone macro research and economic dashboards.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ireland-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 Irish 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":"December 2023 = 100","latest":{"period":"202512","index_value":104.2,"period_label":"2025 December","change_annual_pct":2.8,"change_monthly_pct":0.5},"matrix":"CPM01","series":[{"period":"202512","index_value":104.2,"period_label":"2025 December","change_annual_pct":2.8,"change_monthly_pct":0.5},{"period":"202511","index_value":103.7,"period_label":"2025 November","change_annual_pct":3.2,"change_monthly_pct":-0.2},{"period":"202510","index_value":103.9,"period_label":"2025 October","change_annual_pct":2.9,"change_monthly_pct":0.5},{"period":"202509","index_value":103.4,"period_label":"2025 September","change_annual_pct":2.7,"change_monthly_pct":-0.2},{"period":"202508","index_value":103.6,"period_label":"2025 August","change_annual_pct":2,"change_monthly_pct":0.4},{"period":"202507","index_value":103.2,"period_label":"2025 July","change_annual_pct":1.7,"change_monthly_pct":0.1},{"period":"202506","index_value":103.1,"period_label":"2025 June","change_annual_pct":1.8,"change_monthly_pct":0.5},{"period":"202505","index_value":102.6,"period_label":"2025 May","change_annual_pct":1.7,"change_monthly_pct":0},{"period":"202504","index_value":102.6,"period_label":"2025 April","change_annual_pct":2.2,"change_monthly_pct":0.4},{"period":"202503","index_value":102.2,"period_label":"2025 March","change_annual_pct":2,"change_monthly_pct":0.7},{"period":"202502","index_value":101.5,"period_label":"2025 February","change_annual_pct":1.8,"change_monthly_pct":0.9},{"period":"202501","index_value":100.6,"period_label":"2025 January","change_annual_pct":1.9,"change_monthly_pct":-0.8}],"source":"Central Statistics Office Ireland (CSO)","measure":"Consumer price index","commodity_group":"All items"},"meta":{"timestamp":"2026-06-15T11:14:33.397Z","request_id":"4cd49ce7-9195-4695-afdc-295958a736fc"},"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/dataset":{"get":{"operationId":"get_v1_dataset","tags":["Data"],"summary":"Any CSO PxStat matrix as a time-series","description":"","parameters":[{"name":"matrix","in":"query","required":true,"description":"CSO matrix code","schema":{"type":"string"},"example":"CPM01"},{"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,"title":"Consumer Price Index","matrix":"CPM01","series":[{"value":104.2,"period":"202512","period_label":"2025 December"},{"value":103.7,"period":"202511","period_label":"2025 November"},{"value":103.9,"period":"202510","period_label":"2025 October"},{"value":103.4,"period":"202509","period_label":"2025 September"},{"value":103.6,"period":"202508","period_label":"2025 August"},{"value":103.2,"period":"202507","period_label":"2025 July"},{"value":103.1,"period":"202506","period_label":"2025 June"},{"value":102.6,"period":"202505","period_label":"2025 May"},{"value":102.6,"period":"202504","period_label":"2025 April"},{"value":102.2,"period":"202503","period_label":"2025 March"},{"value":101.5,"period":"202502","period_label":"2025 February"},{"value":100.6,"period":"202501","period_label":"2025 January"}],"constrained":{"STATISTIC":{"pos":0,"code":"CPM01C08","label":"Consumer Price Index (Base Dec 2023=100)"},"C01779V03424":{"pos":0,"code":"-","label":"All items"}},"time_dimension":"TLIST(M1)"},"meta":{"timestamp":"2026-06-15T11:14:33.497Z","request_id":"78c77f37-a8a3-43db-bf55-6875d3cfd88c"},"status":"ok","message":"Dataset 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 PxStat matrix catalogue","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Search term (label or matrix code)","schema":{"type":"string"},"example":"price"},{"name":"limit","in":"query","required":false,"description":"Max results (1-200)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"query":"price","total":12694,"tables":[{"label":"Sheep Price (including VAT)","matrix":"AJA02","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(A1)","C01782V02140"]},{"label":"Pig Price (including VAT)","matrix":"AJA03","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(A1)","C01782V02140"]},{"label":"Feed Stuff Price","matrix":"AJA04","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(A1)","C02068V02499"]},{"label":"Manufacturing Milk and Hen Egg Prices (including VAT)","matrix":"AJA06","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(A1)","C02136V02577"]},{"label":"Sheep Price (including VAT)","matrix":"AJM02","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(M1)","C01782V02140"]},{"label":"Pig Price (including VAT)","matrix":"AJM03","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(M1)","C01782V02140"]},{"label":"Feed Stuff Price","matrix":"AJM04","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(M1)","C02068V02499"]},{"label":"Manufacturing Milk and Hen Egg Prices (including VAT)","matrix":"AJM06","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(M1)","C02136V02577"]},{"label":"Agricultural Input and Output Price Indices","matrix":"AHA01","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(A1)","C02067V02496"]},{"label":"Agricultural Input and Output Price Indices","matrix":"AHA02","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(A1)","C02818V03389"]},{"label":"Agricultural Input and Output Price Indices","matrix":"AHA03","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(A1)","C02818V03389"]},{"label":"Agricultural Input and Output Price Indices","matrix":"AHM03","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(M1)","C02818V03389"]},{"label":"National Average  Price","matrix":"CPM04","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(M1)","C02363V02844"]},{"label":"Consumer Price Index Constant Tax","matrix":"CPM06","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(M1)","C02196V02652"]},{"label":"Consumer Price Index (1922-1967)","matrix":"CPM07","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(M1)","C02071V02502"]},{"label":"National Average Price","matrix":"CPM08","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(M1)","C02438V02948"]},{"label":"Consumer Price Index","matrix":"CPM13","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(M1)","C02439V03429"]},{"label":"Consumer Price Index Goods and Services","matrix":"CPM14","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(M1)","C01779V03424"]},{"label":"Residential Property Price Index","matrix":"HPM01","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(M1)","C02803V03373"]},{"label":"Industrial Price Index (Excl Vat) (Base 2005=100)","matrix":"WPA01","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(A1)","C02596V03150"]},{"label":"Industrial Price Index (Excl VAT) (Base 2010=100)","matrix":"WPA06","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(A1)","C02596V03150"]},{"label":"Industrial Price Index (Excl VAT) (Base 2010=100)","matrix":"WPA07","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(A1)","C02596V03150"]},{"label":"Wholesale Price Index (Excl VAT) (Base 2010=100)","matrix":"WPA08","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(A1)","C01410V02609"]},{"label":"Capital Goods Price Index (Excl VAT) (Base 2010=100)","matrix":"WPA09","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(A1)","C01393V01662"]},{"label":"Wholesale Price Index (Excl VAT)  for Building and Construction Materials (Base 2010=100)","matrix":"WPA10","updated":"2020-05-15T11:00:00Z","dimensions":["STATISTIC","TLIST(A1)","C01409V03262"]}]},"meta":{"timestamp":"2026-06-15T11:14:33.570Z","request_id":"5a23acc5-ab18-42e0-97fb-b3d275bb4270"},"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 (dimensions and value codes)","description":"","parameters":[{"name":"matrix","in":"query","required":true,"description":"CSO matrix code","schema":{"type":"string"},"example":"CPM01"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"title":"Consumer Price Index","matrix":"CPM01","updated":"2026-01-15T11:00:00.000Z","dimensions":[{"id":"STATISTIC","time":false,"label":"Statistic","n_values":8,"sample_values":[{"code":"CPM01C08","label":"Consumer Price Index (Base Dec 2023=100)"},{"code":"CPM01C01","label":"Consumer Price Index (Base Dec 2016=100)"},{"code":"CPM01C02","label":"Consumer Price Index (Base Dec 2011=100)"},{"code":"CPM01C03","label":"Consumer Price Index (Base Dec 2006=100)"},{"code":"CPM01C04","label":"Consumer Price Index (Base Dec 2001=100)"},{"code":"CPM01C05","label":"Consumer Price Index (Base Nov 1996=100)"}]},{"id":"TLIST(M1)","time":true,"label":"Month","n_values":602,"sample_values":[{"code":"197511","label":"1975 November"},{"code":"197512","label":"1975 December"},{"code":"197601","label":"1976 January"},{"code":"197602","label":"1976 February"},{"code":"197603","label":"1976 March"},{"code":"197604","label":"1976 April"}]},{"id":"C01779V03424","time":false,"label":"Commodity Group","n_values":13,"sample_values":[{"code":"-","label":"All items"},{"code":"01","label":"Food and non-alcoholic beverages"},{"code":"02","label":"Alcoholic beverages and tobacco"},{"code":"03","label":"Clothing and footwear"},{"code":"04","label":"Housing, water, electricity, gas and other fuels"},{"code":"05","label":"Furnishings, household equipment and routine household maintenance"}]}]},"meta":{"timestamp":"2026-06-15T11:14:33.658Z","request_id":"76a65b9c-7c7a-412c-bdbe-fe5b30bd4e55"},"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":"matrix is a CSO PxStat matrix code, e.g. CPM01 (consumer prices).","source":"Central Statistics Office Ireland (CSO)","upstream":"https://ws.cso.ie/public/api.restful/PxStat.Data.Cube_API","endpoints":["/v1/cpi","/v1/dataset","/v1/table","/v1/catalog","/v1/meta"],"cpi_matrix":"CPM01","description":"Keyless gateway over Ireland's CSO PxStat (JSON-stat 2.0) API. /v1/cpi gives the latest Irish consumer price index and inflation; /v1/dataset pulls any PxStat matrix as a clean time-series; /v1/table inspects a matrix's dimensions; /v1/catalog searches the matrix catalogue.","documentation":"https://ireland-stats-api.oanor.dev"},"meta":{"timestamp":"2026-06-15T11:14:33.753Z","request_id":"86adbf87-9c3f-4e06-ac41-85ea1095ebb9"},"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":2700,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1160,"monthly_call_quota":50000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2940,"monthly_call_quota":199000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6680,"monthly_call_quota":825000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ireland-stats-api"}