# afriref Pan-African Government Reference Data - Historical Series

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

Returns the full historical time-series of a specific government reference value (policy rate, VAT, minimum wage, or public holidays) for a given African country, with official citations, effective dates, and staleness flags

## Facts

- Endpoint: GET https://afriref.dev/v1/%7Bcountry%7D/%7Bseries%7D/history
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/afriref-pan-african-government-reference-data-historical-series-a24cd6bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Xh4PYQvJOjgQN46wt8BJW

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-pan-african-government-reference-data-historical-series-a24cd6bf
```

Example prompt: Can you pull the full history of Kenya's central bank policy rate from afriref, including the official source citations and effective dates for each change?

## When to prefer this

Use this endpoint when you need the complete time-series history of a government reference value rather than just the latest figure, or when you need machine-readable official citations and effective dates for compliance, audit, or research purposes. Prefer this over web scraping or general search when you need structured, citable African government data with staleness tracking. Best for fintech, compliance, payroll, tax, and macroeconomic applications operating across the 11 supported African markets.

## Known failure modes

- Unsupported country code returns an error — only ci, eg, et, gh, ke, ma, ng, rw, sn, tz, ug are supported
- Unsupported series name returns an error — only policy-rate, vat-rate, minimum-wage, public-holidays are valid
- Stale data flagged with stale:true when the underlying official source has not been re-confirmed recently
- BCEAO/UEMOA shared rates (applicable to ci and sn) may not reflect country-specific nuance and carry a shared-rate note
- Payment failure (x402) if USDC balance is insufficient or wallet is not configured
- Rate limiting or 402 payment errors if the micropayment header is malformed

## How this service works

Authoritative Pan-African government reference values as clean JSON: central-bank policy rates, VAT rates, national minimum wages and public holidays for Côte d'Ivoire (ci), Egypt (eg), Ethiopia (et), Ghana (gh), Kenya (ke), Morocco (ma), Nigeria (ng), Rwanda (rw), Senegal (sn), Tanzania (tz), Uganda (ug). Every value carries a citation to its official primary source (government gazette or central-bank statement), an effective date, a last-confirmed date and a staleness flag.

## Output

A JSON object containing the full historical series of the requested government reference value for the specified country, including: the numeric value with units, series identifier, country code, effective start date, last-confirmed date, a staleness boolean flag, human-readable notes, and a source object with the official URL and name (e.g. government gazette or central-bank communiqué). Also includes a disclaimer noting the service is independent and data should be verified against the cited official source.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "unit": "percent",
  "notes": "SHARED BCEAO/UEMOA rate — this is NOT an Ivorian national rate; the same figure applies to all 8 union members (Bénin, Burkina Faso, Côte d'Ivoire, Guinée-Bissau, Mali, Niger, Sénégal, Togo). The CPM of 4 March 2026 cut the principal rate 25bps from 3.25% to 3.00% (and the marginal lending facility from 5.25% to 5.00%), effective 16 March 2026; the 3.0000% level is corroborated by the weekly liquidity-injection notice of 8 June 2026. Reserve requirement coefficient held at 3.0%. The CPM meets quarterly (roughly March/June/September/December) — re-verify after each meeting.",
  "stale": false,
  "value": 3,
  "series": "policy-rate",
  "source": {
   "url": "https://www.bceao.int/fr/communique-presse/reunion-ordinaire-du-comite-de-politique-monetaire-de-la-bceao-tenue-le-4-mars",
   "name": "BCEAO — Communiqué de presse, réunion ordinaire du CPM tenue le 4 mars 2026 (-25bps, effet 16 mars 2026)"
  },
  "country": "CI",
  "disclaimer": "Independent service, not affiliated with any government. Verify against the cited official source before legal or financial use.",
  "effective_from": "2026-03-16",
  "last_confirmed": "2026-07-15"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/afriref-pan-african-government-reference-data-historical-series-a24cd6bf/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)