# Australian Bureau of Statistics API
> A gateway to the official Australian Bureau of Statistics (ABS) SDMX data service. Read the latest headline Consumer Price Index, browse and search the 1,200-plus ABS statistical dataflows by id or name, and fetch the latest observations for any ABS series by its dataflow id and SDMX series key with as many recent periods as you need. Every observation carries its reference period, and values always resolve to the latest published release, so there are no dates to hard-code. Built for Australian macro research, CPI and inflation tracking, and AUD currency or rates models that need authoritative national statistics. Distinct from our OECD cross-country indicators and Statistics Canada feed: this surfaces the official ABS data service for Australia.

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

## Pricing
- **Free** (Free) — 2,140 calls/Mo, 2 req/s
- **Basic** ($13/Mo) — 53,800 calls/Mo, 6 req/s
- **Pro** ($35/Mo) — 214,000 calls/Mo, 16 req/s
- **Scale** ($80/Mo) — 904,000 calls/Mo, 40 req/s

## Endpoints

### Indicators

#### `GET /v1/cpi` — Latest headline Consumer Price Index

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

**Response:**
```json
{
    "data": {
        "unit": "index",
        "value": 101.7,
        "period": "2026-Q1",
        "source": "Australian Bureau of Statistics",
        "country": "Australia",
        "indicator": "Consumer Price Index (All groups, weighted average of eight capital cities)"
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:54.720Z",
        "request_id": "8c4dda82-0b6d-4780-998a-830a9b5f0e95"
    },
    "status": "ok",
    "message": "CPI retrieved successfully",
    "success": true
}
```

### Reference

#### `GET /v1/dataflows` — List/search ABS dataflows

**Parameters:**
- `search` (query, optional, string) — Filter by id or name Example: `consumer price`
- `limit` (query, optional, string) — Max rows (1-500) Example: `100`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/abs-api/v1/dataflows?search=consumer+price&limit=100"
```

**Response:**
```json
{
    "data": {
        "count": 4,
        "total": 4,
        "dataflows": [
            {
                "id": "CPI",
                "name": "Consumer Price Index (CPI)",
                "version": "2.0.0"
            },
            {
                "id": "CPI_M",
                "name": "Monthly Consumer Price Index (CPI) indicator",
                "version": "1.2.0"
            },
            {
                "id": "CPI_Q",
                "name": "Consumer Price Index (CPI) Quarterly",
                "version": "1.0.0"
            },
            {
                "id": "CPI_WEIGHTS",
                "name": "Consumer Price Index (CPI) Weights",
                "version": "1.0.0"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:55.479Z",
        "request_id": "b8d2bb68-3af2-4c02-974f-3f6355cbb660"
    },
    "status": "ok",
    "message": "Dataflows retrieved successfully",
    "success": true
}
```

### Data

#### `GET /v1/data` — Latest observations for any series

**Parameters:**
- `dataflow` (query, required, string) — ABS dataflow id Example: `CPI`
- `key` (query, required, string) — SDMX series key Example: `1.10001.10.50.Q`
- `periods` (query, optional, string) — Number of recent periods (1-60) Example: `8`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/abs-api/v1/data?dataflow=CPI&key=1.10001.10.50.Q&periods=8"
```

**Response:**
```json
{
    "data": {
        "key": "1.10001.10.50.Q",
        "count": 8,
        "source": "Australian Bureau of Statistics",
        "dataflow": "CPI",
        "observations": [
            {
                "value": 101.7,
                "period": "2026-Q1"
            },
            {
                "value": 100.32,
                "period": "2025-Q4"
            },
            {
                "value": 99.73,
                "period": "2025-Q3"
            },
            {
                "value": 98.43,
                "period": "2025-Q2"
            },
            {
                "value": 97.7,
                "period": "2025-Q1"
            },
            {
                "value": 96.81,
                "period": "2024-Q4"
            },
            {
                "value": 96.62,
                "period": "2024-Q3"
            },
            {
                "value": 96.41,
                "period": "2024-Q2"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:57.249Z",
        "request_id": "f5dc2b21-78fa-4ae7-a7e4-1c462f7e47b4"
    },
    "status": "ok",
    "message": "Data retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "name": "Australian Bureau of Statistics API",
        "source": "Australian Bureau of Statistics Data API (data.api.abs.gov.au)",
        "country": "Australia",
        "endpoints": [
            {
                "path": "/v1/cpi",
                "description": "Latest headline Consumer Price Index"
            },
            {
                "path": "/v1/dataflows",
                "description": "List/search ABS dataflows (?search=cpi&limit=100)"
            },
            {
                "path": "/v1/data",
                "description": "Latest observations for any series (?dataflow=CPI&key=1.10001.10.50.Q&periods=8)"
            },
            {
                "path": "/v1/meta",
                "description": "This metadata document"
            }
        ],
        "disclaimer": "Unofficial proxy of the public ABS Data API. Not affiliated with the Australian Bureau of Statistics. Data only; refer to the ABS for authoritative figures.",
        "description": "A gateway to the official Australian Bureau of Statistics (ABS) SDMX data service. Read the latest headline CPI, browse and search the 1,200+ ABS statistical dataflows, and fetch the latest observations for any ABS series by its dataflow id and SDMX key. Values always resolve to the latest published period."
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:57.358Z",
        "request_id": "d3ef290c-9c68-4519-aa59-921120937ee3"
    },
    "status": "ok",
    "message": "Met
…(truncated, see openapi.json for full schema)
```


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