# Greenland Statistics API
> Official Greenlandic statistics from Statistics Greenland (Naatsorsueqqissaartarfik) as a clean, keyless JSON API. Get the latest Greenlandic consumer price index and inflation — index level (base January 2008 = 100) and year-on-year change, published half-yearly (H1 = January, H2 = July) back to 1971 — pull any table in the Statistics Greenland PxWeb catalogue as a tidy time-series (prices, fisheries and catch, foreign trade, businesses, energy, education) without wrestling with the json-stat2 format, inspect a table's variables and value codes, and browse the database tree. A thin gateway over Statistics Greenland's public PxWeb API: you supply a table path and optional dimension selection, we return the latest periods as plain period/value rows. Ideal for Arctic and Nordic macro research, inflation trackers 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/greenland-stats-api/..."
```

## Pricing
- **Free** (Free) — 2,200 calls/Mo, 3 req/s
- **Basic** ($11/Mo) — 46,500 calls/Mo, 10 req/s
- **Pro** ($29/Mo) — 191,000 calls/Mo, 25 req/s
- **Mega** ($65/Mo) — 792,000 calls/Mo, 60 req/s

## Endpoints

### Inflation

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

**Parameters:**
- `periods` (query, optional, string) — Number of recent half-years (1-40) Example: `8`

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

**Response:**
```json
{
    "data": {
        "base": "January 2008 = 100",
        "latest": {
            "period": "2026H1",
            "index_value": 139.4,
            "change_annual_pct": 3.7
        },
        "series": [
            {
                "period": "2026H1",
                "index_value": 139.4,
                "change_annual_pct": 3.7
            },
            {
                "period": "2025H2",
                "index_value": 137.5,
                "change_annual_pct": 3.6
            },
            {
                "period": "2025H1",
                "index_value": 134.4,
                "change_annual_pct": null
            },
            {
                "period": "2024H2",
                "index_value": 132.7,
                "change_annual_pct": 2.8
            },
            {
                "period": "2024H1",
                "index_value": 129.8,
                "change_annual_pct": 2.2
            },
            {
                "period": "2023H2",
                "index_value": 129,
                "change_annual_pct": 2.5
            },
            {
                "period": "2023H1",
                "index_value": 127,
                "change_annual_pct": 2.7
            },
            {
                "period": "2022H2",
                "index_value": 125.9,
                "change_annual_pct": 2.2
            }
        ],
        "source": "Statistics Greenland",
        "measure": "Consumer price index",
        "frequency": "half-yearly (H1=Jan, H2=Ju
…(truncated, see openapi.json for full schema)
```

### Data

#### `GET /v1/series` — Any PxWeb table as a time-series

**Parameters:**
- `path` (query, required, string) — PxWeb table path (ends in .px) Example: `PR/PRXPRISF.px`
- `select` (query, optional, string) — Dimension constraints "Code:Value;Code:Value" Example: `index:4`
- `periods` (query, optional, string) — Recent periods (1-120) Example: `12`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/greenland-stats-api/v1/series?path=PR%2FPRXPRISF.px&select=index%3A4&periods=12"
```

**Response:**
```json
{
    "data": {
        "path": "PR/PRXPRISF.px",
        "title": "Consumer Price Index by time and index",
        "series": [
            {
                "value": 139.4,
                "period": "2026H1"
            },
            {
                "value": 137.5,
                "period": "2025H2"
            },
            {
                "value": 134.4,
                "period": "2025H1"
            },
            {
                "value": 132.7,
                "period": "2024H2"
            },
            {
                "value": 129.8,
                "period": "2024H1"
            },
            {
                "value": 129,
                "period": "2023H2"
            },
            {
                "value": 127,
                "period": "2023H1"
            },
            {
                "value": 125.9,
                "period": "2022H2"
            },
            {
                "value": 123.6,
                "period": "2022H1"
            },
            {
                "value": 123.2,
                "period": "2021H2"
            },
            {
                "value": 123.3,
                "period": "2021H1"
            },
            {
                "value": 123.4,
                "period": "2020H2"
            }
        ],
        "constrained": {
            "index": {
                "pos": 0,
                "code": "4",
                "label": "Jan 2008=100"
            }
        },
        "time_dimension": "time"
    },
    "
…(truncated, see openapi.json for full schema)
```

### Catalog

#### `GET /v1/databases` — Browse the database tree

**Parameters:**
- `path` (query, optional, string) — Sub-path to list (omit for root) Example: `PR`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/greenland-stats-api/v1/databases?path=PR"
```

**Response:**
```json
{
    "data": {
        "path": "PR",
        "count": 9,
        "items": [
            {
                "id": "PRXBYG1.px",
                "text": "Construction cost index(2006=100) by building trade and type (2006H1-2025H2) [PREBYG1]",
                "type": "t"
            },
            {
                "id": "PRXBYG2.px",
                "text": "Building Cost Index for Dwellings (2025H1=100) [PREBYG2]",
                "type": "t"
            },
            {
                "id": "PRXPLI.px",
                "text": "Price level index (index DK=100) by commodity group (2014-2016)",
                "type": "t"
            },
            {
                "id": "PRXPRISF.px",
                "text": "Consumer price index series (1971H1-2026H1) [PREPRISF]",
                "type": "t"
            },
            {
                "id": "PRXPRISG.px",
                "text": "Rate of change per cent per six months, Consumer price index (1971H2-2026H1) [PREPRISG]",
                "type": "t"
            },
            {
                "id": "PRXPRISH.px",
                "text": "Rate of change last 12 months, Consumer price index (1972H1-2026H1) [PREPRISH]",
                "type": "t"
            },
            {
                "id": "PRXPRISR.px",
                "text": "Wage regulating price index series (1971H1-2026H1) [PREPRISR]",
                "type": "t"
            },
            {
                "id": "PRXPRISV.px",
                "text": "Consumer pri
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/table` — Table metadata (variables and value codes)

**Parameters:**
- `path` (query, required, string) — PxWeb table path (ends in .px) Example: `PR/PRXPRISF.px`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/greenland-stats-api/v1/table?path=PR%2FPRXPRISF.px"
```

**Response:**
```json
{
    "data": {
        "path": "PR/PRXPRISF.px",
        "title": "Consumer Price Index by time and index",
        "variables": [
            {
                "code": "time",
                "text": "time",
                "time": true,
                "n_values": 111,
                "sample_values": [
                    {
                        "code": "106",
                        "text": "2024H1"
                    },
                    {
                        "code": "107",
                        "text": "2024H2"
                    },
                    {
                        "code": "108",
                        "text": "2025H1"
                    },
                    {
                        "code": "109",
                        "text": "2025H2"
                    },
                    {
                        "code": "110",
                        "text": "2026H1"
                    }
                ]
            },
            {
                "code": "index",
                "text": "index",
                "time": false,
                "n_values": 5,
                "sample_values": [
                    {
                        "code": "0",
                        "text": "Jan 1971=100"
                    },
                    {
                        "code": "1",
                        "text": "Jan 1975=100"
                    },
                    {
                        "code": "2",
                        "text": "Jan 1981
…(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/greenland-stats-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Statistics Greenland (Naatsorsueqqissaartarfik)",
        "upstream": "https://bank.stat.gl/api/v1/en/Greenland",
        "cpi_table": "PR/PRXPRISF.px",
        "databases": [
            "ES Businesses",
            "FI Fisheries and catch",
            "IE Foreign trade",
            "PR Prices",
            "UD Education",
            "EN Energy"
        ],
        "endpoints": [
            "/v1/cpi",
            "/v1/series",
            "/v1/table",
            "/v1/databases",
            "/v1/meta"
        ],
        "description": "Keyless gateway over Statistics Greenland's PxWeb API. /v1/cpi gives the latest Greenlandic consumer price index and annual inflation; /v1/series pulls any PxWeb table as a clean time-series; /v1/table and /v1/databases discover the catalog.",
        "documentation": "https://greenland-stats-api.oanor.dev"
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:44.310Z",
        "request_id": "d153d083-829d-4e79-876a-de3e816baf4a"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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