# afriref Certified Country/Series Lookup

> afriref Certified Country/Series Lookup is a paid API for AI agents from afriref.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-29).

Returns a single certified government reference data value (e.g. policy rate, VAT rate, CPI) for one African country and one data series, with official source URL and last-confirmed date

## Facts

- Endpoint: GET https://afriref.dev/v1/certified/%7Bcountry%7D/%7Bseries%7D?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/afriref-certified-country-series-lookup-fa0c276c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OIPbZBhXu3Agg-iMVnCln

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-certified-country-series-lookup-fa0c276c
```

Example prompt: What is the current central bank policy rate for Nigeria according to afriref — pull the certified official figure with its source and last-confirmed date.

## When to prefer this

Use this endpoint when you need a single, authoritative, source-cited government reference value for one African country and one specific data series (e.g. VAT rate, policy rate, CPI). Prefer it over general web search or LLM knowledge when you need an official citation, a last-confirmed date, and a staleness signal. Choose the country brief endpoint instead if you need all series for one country in one call, or the cross-country compare endpoint if you need one series across multiple countries.

## Known failure modes

- Country not in the 34-country coverage set — endpoint refuses and returns an error
- Series not available for the requested country — partial coverage results in refusal
- Stale data flag set if the value has not been re-confirmed recently
- Payment failure if USDC/x402 transaction is not completed
- Invalid country or series parameter format returns a validation error

## How this service works

Pan-African government reference data for 34 countries as cited JSON: central-bank policy rates, VAT/GST and VAT registration thresholds, CPI, corporate, personal and withholding tax, social contributions, minimum wages, statutory interest, official FX rates, filing deadlines and public holidays (coverage varies by country). Every value carries its official source URL and last-confirmed date. Single facts $0.003; country brief (every series for one country) $0.01; cross-country compare (one series, up to 10 countries) $0.02; tax-ID and VAT-number checks $0.003; computed answers (VAT, income tax, working days, minimum-wage check) $0.01-$0.02. Pay per call in USDC on Base via x402 or MPP, no signup, or by card with credit packs or monthly plans on one key valid across all 7 regional services. Free tier: GET /catalog, plus a free email key with 50 answer calls a day, commercial use allowed. Finished answers, one cited dossier per call (supported countries vary per job; others are refused free): cost this hire (wage-floor verdict, contributions, employer cost) $0.50; charge this sale (which VAT applies, net/VAT/gross) $0.50; charge this sale certified (plus a signed VAT-rate extract) $0.75; invoice due date and statutory late interest $0.40; country evidence pack (brief plus signed extracts) $0.25; hire compare $0.75 for 2 countries, $1.00 for 3-5; next filings (VAT, PAYE, corporate-tax due dates rolled for holidays) $0.35. Also here: domain and email-security check $0.01 per domain - graded TLS certificate on port 443, Microsoft 365 tenant detection, and SPF, DKIM, DMARC and MX with the exact fix records.

Free trial: 3 computed-answer calls per day per IP on POST /v1/answers/* with header X-Free-Trial: 1 (without it, the normal x402 402; once used up, the 402 carries free_trial_resets_at). MCP answer tools use the trial automatically when no api_key is passed. Every series of the evaluation country is free. Card credit (same per-call price as x402): /pricing.

## Output

A JSON object containing the requested government reference data value for the specified African country and series, accompanied by the official government source URL, the last-confirmed date, and a staleness indicator. The response represents a single certified data point (one country, one series).

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/afriref-certified-country-series-lookup-fa0c276c/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)