# Ireland Statistics API
> 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.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/ireland-stats-api/..."
```

## Pricing
- **Free** (Free) — 2,700 calls/Mo, 3 req/s
- **Basic** ($12/Mo) — 50,000 calls/Mo, 10 req/s
- **Pro** ($29/Mo) — 199,000 calls/Mo, 25 req/s
- **Mega** ($67/Mo) — 825,000 calls/Mo, 60 req/s

## Endpoints

### Inflation

#### `GET /v1/cpi` — Latest Irish CPI and inflation

**Parameters:**
- `periods` (query, optional, string) — Number of recent months (1-120) Example: `12`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ireland-stats-api/v1/cpi?periods=12"
```

**Response:**
```json
{
    "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
            },
  
…(truncated, see openapi.json for full schema)
```

### Data

#### `GET /v1/dataset` — Any CSO PxStat matrix as a time-series

**Parameters:**
- `matrix` (query, required, string) — CSO matrix code Example: `CPM01`
- `periods` (query, optional, string) — Recent periods (1-240) Example: `12`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ireland-stats-api/v1/dataset?matrix=CPM01&periods=12"
```

**Response:**
```json
{
    "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",
      
…(truncated, see openapi.json for full schema)
```

### Catalog

#### `GET /v1/catalog` — Search the PxStat matrix catalogue

**Parameters:**
- `q` (query, optional, string) — Search term (label or matrix code) Example: `price`
- `limit` (query, optional, string) — Max results (1-200) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ireland-stats-api/v1/catalog?q=price&limit=25"
```

**Response:**
```json
{
    "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)",
                "matri
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/table` — Matrix metadata (dimensions and value codes)

**Parameters:**
- `matrix` (query, required, string) — CSO matrix code Example: `CPM01`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ireland-stats-api/v1/table?matrix=CPM01"
```

**Response:**
```json
{
    "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"
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ireland-stats-api/v1/meta"
```

**Response:**
```json
{
    "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
}
```


---
Marketplace page: https://www.oanor.com/api/ireland-stats-api
OpenAPI spec: https://www.oanor.com/api/ireland-stats-api/openapi.json