# Åland Consumer Price Index API
> Official consumer-price-index and inflation data for the Åland Islands — the autonomous, Swedish-speaking, euro-area region of Finland — sourced live from Statistics and Research Åland (ÅSUB), the regional statistics authority, via its public PxWeb API (table KO010). The overall endpoint returns the latest headline CPI level (index base 2025 = 100) together with month-on-month and year-on-year change. The series endpoint returns the full monthly history of the headline index with monthly and annual change, parameterised by the number of months. The divisions endpoint breaks the basket down across the thirteen COICOP groups — food, alcohol & tobacco, clothing, housing & utilities, furnishings, health, transport, communication, recreation & culture, education, restaurants & hotels, miscellaneous and personal care — each with its index level and annual change. The drivers endpoint ranks those same divisions by their annual impact in percentage points, showing exactly which categories are pushing Åland inflation up or down. Figures are published directly by ÅSUB, not modelled or estimated, and are refreshed from source. Ideal for macro and regional-economics dashboards, cost-of-living and salary tools, Nordic and euro-area inflation trackers, and fintech that needs a clean, structured CPI feed for a market the big aggregators ignore. Live keyless upstream, short server-side cache. 5 endpoints.

## 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/aland-stats-api/..."
```

## Pricing
- **Free** (Free) — 220 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 13,400 calls/Mo, 6 req/s
- **Pro** ($34/Mo) — 64,000 calls/Mo, 12 req/s
- **Mega** ($83/Mo) — 240,000 calls/Mo, 30 req/s

## Endpoints

### CPI

#### `GET /v1/cpi` — Headline CPI (latest)

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

**Response:**
```json
{
    "data": {
        "base": "2025 = 100",
        "index": 101.73,
        "period": "2026M05",
        "region": "Åland Islands",
        "source": "Statistics and Research Åland (ÅSUB, table KO010)",
        "indicator": "Consumer Price Index (overall)",
        "period_iso": "2026-05",
        "change_mom_pct": 0.4,
        "change_yoy_pct": 1.7
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:29.044Z",
        "request_id": "a42b80ba-a30a-47b7-bdfb-5dd75043c14b"
    },
    "status": "ok",
    "message": "Åland CPI retrieved",
    "success": true
}
```

#### `GET /v1/cpi/divisions` — CPI by COICOP division

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

**Response:**
```json
{
    "data": {
        "base": "2025 = 100",
        "count": 13,
        "period": "2026M05",
        "region": "Åland Islands",
        "source": "ÅSUB KO010",
        "divisions": [
            {
                "index": 101.32,
                "label": "Food & non-alcoholic beverages",
                "coicop": "01",
                "change_yoy_pct": 1.1
            },
            {
                "index": 102.72,
                "label": "Alcoholic beverages & tobacco",
                "coicop": "02",
                "change_yoy_pct": 3.2
            },
            {
                "index": 100.79,
                "label": "Clothing & footwear",
                "coicop": "03",
                "change_yoy_pct": 0.5
            },
            {
                "index": 99.75,
                "label": "Housing, water, electricity, gas & fuels",
                "coicop": "04",
                "change_yoy_pct": 0.5
            },
            {
                "index": 102.12,
                "label": "Furnishings & household equipment",
                "coicop": "05",
                "change_yoy_pct": 1.1
            },
            {
                "index": 111.85,
                "label": "Health",
                "coicop": "06",
                "change_yoy_pct": 5.5
            },
            {
                "index": 105.12,
                "label": "Transport",
                "coicop": "07",
                "change_yoy_pct": 5.7
            },
            {
      
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/cpi/drivers` — Inflation drivers (annual impact)

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

**Response:**
```json
{
    "data": {
        "count": 13,
        "period": "2026M05",
        "region": "Åland Islands",
        "source": "ÅSUB KO010",
        "drivers": [
            {
                "label": "Transport",
                "coicop": "07",
                "annual_impact_pp": 0.8
            },
            {
                "label": "Health",
                "coicop": "06",
                "annual_impact_pp": 0.2
            },
            {
                "label": "Restaurants & hotels",
                "coicop": "11",
                "annual_impact_pp": 0.2
            },
            {
                "label": "Miscellaneous goods & services",
                "coicop": "12",
                "annual_impact_pp": -0.2
            },
            {
                "label": "Food & non-alcoholic beverages",
                "coicop": "01",
                "annual_impact_pp": 0.1
            },
            {
                "label": "Alcoholic beverages & tobacco",
                "coicop": "02",
                "annual_impact_pp": 0.1
            },
            {
                "label": "Housing, water, electricity, gas & fuels",
                "coicop": "04",
                "annual_impact_pp": 0.1
            },
            {
                "label": "Communication",
                "coicop": "08",
                "annual_impact_pp": 0.1
            },
            {
                "label": "Recreation & culture",
                "coicop": "09",
                "annual_impact_
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/cpi/series` — CPI monthly series

**Parameters:**
- `months` (query, optional, string) — Number of most recent months to return Example: `24`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aland-stats-api/v1/cpi/series?months=24"
```

**Response:**
```json
{
    "data": {
        "base": "2025 = 100",
        "count": 17,
        "region": "Åland Islands",
        "series": [
            {
                "index": 100.37,
                "period": "2025M01",
                "period_iso": "2025-01",
                "change_mom_pct": null,
                "change_yoy_pct": null
            },
            {
                "index": 100.57,
                "period": "2025M02",
                "period_iso": "2025-02",
                "change_mom_pct": 0.2,
                "change_yoy_pct": null
            },
            {
                "index": 100.41,
                "period": "2025M03",
                "period_iso": "2025-03",
                "change_mom_pct": -0.2,
                "change_yoy_pct": null
            },
            {
                "index": 100.2,
                "period": "2025M04",
                "period_iso": "2025-04",
                "change_mom_pct": -0.2,
                "change_yoy_pct": null
            },
            {
                "index": 100,
                "period": "2025M05",
                "period_iso": "2025-05",
                "change_mom_pct": -0.2,
                "change_yoy_pct": null
            },
            {
                "index": 99.92,
                "period": "2025M06",
                "period_iso": "2025-06",
                "change_mom_pct": -0.1,
                "change_yoy_pct": null
            },
            {
                "index": 100.31,
                "perio
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

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

**Response:**
```json
{
    "data": {
        "api": "Statistics Åland (ÅSUB) API",
        "notes": "Live data from ÅSUB PxWeb (json-stat2). Index 2025=100; annual/monthly change and annual impact are published directly.",
        "region": "Åland Islands (autonomous region of Finland, euro area)",
        "source": "Statistics and Research Åland — ÅSUB PxWeb API (pxweb.asub.ax), table KO010",
        "endpoints": [
            "/v1/cpi",
            "/v1/cpi/series",
            "/v1/cpi/divisions",
            "/v1/cpi/drivers",
            "/v1/meta"
        ],
        "documentation": "https://aland-stats-api.oanor.dev",
        "primary_indicator": "Consumer Price Index (2025=100), overall + 13 COICOP divisions, with annual/monthly change and annual impact"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:29.384Z",
        "request_id": "965287c8-0f07-466e-83a4-2c9330fead28"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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