---
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://afriref.dev`
- URL: `https://afriref.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` 'ao' | 'bf' | 'bj' | 'bw' | 'cd' | 'cf' | 'cg' | 'ci' | 'cm' | 'dz' | 'eg' | 'et' | 'ga' | 'gh' | 'gq' | 'ke' | 'ls' | 'ma' | 'ml' | 'mu' | 'mz' | 'na' | 'ne' | 'ng' | 'rw' | 'sn' | 'sz' | 'td' | 'tg' | 'tn' | 'tz' | 'ug' | 'za' | 'zm', required
- `series` 'policy-rate' | 'vat' | 'vat-registration-threshold' | 'minimum-wage' | 'public-holidays' | 'cpi' | 'corporate-tax' | 'withholding-tax' | 'statutory-interest' | '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/afriref/apis/afriref-pan-african-government-reference-data.md) · [All operations](https://skmtc.dev/afriref/apis/afriref-pan-african-government-reference-data/llms.txt) · [OpenAPI document](https://skmtc.dev/afriref/apis/afriref-pan-african-government-reference-data/revisions/d78528e9f644?raw)