---
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://euroref.dev`
- URL: `https://euroref.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` 'at' | 'be' | 'bg' | 'ch' | 'cy' | 'cz' | 'de' | 'dk' | 'ee' | 'es' | 'eu' | 'fi' | 'fr' | 'gb' | 'gr' | 'hr' | 'hu' | 'ie' | 'is' | 'it' | 'lt' | 'lu' | 'lv' | 'mt' | 'nl' | 'no' | 'pl' | 'pt' | 'ro' | 'rs' | 'se' | 'si' | 'sk' | 'tr' | 'ua', required
- `series` 'policy-rate' | 'vat' | 'vat-registration-threshold' | 'minimum-wage' | 'public-holidays' | 'cpi' | 'corporate-tax' | 'withholding-tax' | 'income-tax' | 'social-contributions' | 'ecb-main-refinancing-rate' | 'late-payment-interest' | 'statutory-interest' | 'filing-deadlines' | 'fx-reference', 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/euroref/apis/euroref-european-government-reference-data.md) · [All operations](https://skmtc.dev/euroref/apis/euroref-european-government-reference-data/llms.txt) · [OpenAPI document](https://skmtc.dev/euroref/apis/euroref-european-government-reference-data/revisions/1c3a0bb74c77?raw)