# afriref Payroll Reference Data

> afriref Payroll 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-09-13).

Returns authoritative payroll-relevant government reference values (central-bank policy rates, VAT rates, national minimum wages, public holidays) for 11 African countries as clean JSON with official citations.

## Facts

- Endpoint: GET https://afriref.dev/v1/answers/payroll
- 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-payroll-reference-data-54b9241d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u0OQMi8ZIfilwTHYUYVYN

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-payroll-reference-data-54b9241d
```

Example prompt: What is the current central bank policy rate and VAT rate for Nigeria, with official source citations — I need it for payroll compliance?

## When to prefer this

Choose this endpoint when you need authoritative, cited, machine-readable payroll and compliance reference data (policy rates, VAT, minimum wage, public holidays) for one of the 11 supported African countries and require traceable official sources rather than scraped or uncited figures. It is especially valuable for payroll automation, compliance validation, or regulatory reporting pipelines targeting African markets.

## Known failure modes

- Unsupported country code returns an error or empty result
- Requested data series not available for the given country
- Data marked as stale when last-confirmed date exceeds threshold
- Network or upstream error returning non-200 response
- Rate-limit or payment failure (x402 payment required)

## 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 requested government reference value (e.g. policy rate, VAT rate, minimum wage, or public holidays) for the specified African country, along with the numeric value and unit, effective date, last-confirmed date, a staleness flag, and a citation object pointing to the official primary source (government gazette or central bank statement), plus a disclaimer note.

## 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-payroll-reference-data-54b9241d/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)