# afriref History Series — Pan-African Government Reference Data

> afriref History Series — Pan-African Government Reference Data is a paid API for AI agents from afriref.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-16).

Returns the full historical time-series for a single government reference data series (policy rate, VAT, minimum wage, or holidays) for a given African country, with gazette citations and staleness indicators.

## Facts

- Endpoint: GET https://afriref.dev/v1/:country/:series/history?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/afriref-history-series-pan-african-government-reference-data-ef90d9b4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cRGfyh-9ROKzzBJCWA5n5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability afriref-history-series-pan-african-government-reference-data-ef90d9b4
```

Example prompt: Pull the full history of Kenya's central bank policy rate from afriref — I need all the gazette-cited historical values with their confirmation dates and any staleness flags.

## When to prefer this

Use this endpoint when you need the full longitudinal record of a government reference series for a specific African country — not just the current value. It is ideal for trend analysis, compliance audits, historical modelling, or verifying how a regulatory figure has changed over time. Prefer this over the snapshot endpoint when time-series context matters.

## Known failure modes

- Invalid ISO country code returns 404 or empty result
- Unsupported series ID returns 404 or error
- Country/series combination with no historical data returns empty array
- Network or payment (x402) failure returns 402 or 5xx
- Stale data returned without error when gazette source hasn't been re-confirmed

## How this service works

Côte d'Ivoire: CPI inflation (year-on-year) — gazette-cited JSON with last_confirmed and stale.

## Output

A JSON array of historical data points for the requested country and series, each entry containing the reference value (e.g. rate percentage, monetary amount, or holiday list), the effective date, gazette or statutory citation, a last_confirmed timestamp, and a stale boolean flag indicating whether the entry may be out of date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "country",
      "series"
     ],
     "properties": {
      "series": {
       "type": "string",
       "description": "Reference series id"
      },
      "country": {
       "type": "string",
       "description": "ISO country code"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {},
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/afriref-history-series-pan-african-government-reference-data-ef90d9b4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from afriref.dev](https://www.zero.xyz/host/afriref.dev/llms.txt)