---
title: "Historical values of a series, filterable by date range"
method: GET
path: "/v1/{country}/{series}/history"
tags: ["Reference data"]
---

# Historical values of a series, filterable by date range

`GET /v1/{country}/{series}/history`

## Request

- Base URL: `https://ausref.dev`
- URL: `https://ausref.dev/v1/{country}/{series}/history`
- Auth: one of:
  - API key in header `PAYMENT-SIGNATURE`
  - API key in header `X-PAYMENT`
  - API key in header `X-API-Key`

## Path parameters

- `country` 'au' | 'fj' | 'nz' | 'pg' | 'sb' | 'to' | 'vu' | 'ws', required
- `series` 'policy-rate' | 'statutory-interest' | 'vat' | 'vat-registration-threshold' | 'minimum-wage' | 'public-holidays' | 'cpi' | 'corporate-tax' | 'withholding-tax' | 'income-tax' | 'social-contributions' | 'fx-reference' | 'filing-deadlines', required

## Query parameters

- `from` string, date
- `to` string, date

## Response `200`

Historical entries. Top-level labels describe the current value; each entry carries its own.

- object
  - `country` string
  - `series` string
  - `stale` boolean
  - `entries` object[]
    - `confidence_label` 'high' | 'medium' | 'low': Derived from source type, verification age, stale. Rules: /label-rules
    - `coverage_label` 'ready' | 'partial' | 'gap': ready=complete, partial=limited, gap=no number. Rules: /label-rules
    - `label_basis` object: Inputs and rule ids behind both labels
  - `confidence_label` 'high' | 'medium' | 'low': Derived from source type, verification age, stale. Rules: /label-rules
  - `coverage_label` 'ready' | 'partial' | 'gap': ready=complete, partial=limited, gap=no number. Rules: /label-rules
  - `label_basis` object: Inputs and rule ids behind both labels

## Other responses

- `402`: Payment Required
- `404`: Unknown country or series

---

[API](https://skmtc.dev/ausref/apis/ausref-australasian-government-reference-data.md) · [All operations](https://skmtc.dev/ausref/apis/ausref-australasian-government-reference-data/llms.txt) · [OpenAPI document](https://skmtc.dev/ausref/apis/ausref-australasian-government-reference-data/revisions/002874ef252c?raw)