# Afriref Compare — Cross-Country African Reference Data

> Afriref Compare — Cross-Country African Reference Data is a paid API for AI agents from afriref.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Compares a single government reference data series (e.g. VAT, policy rate, minimum wage) across up to 10 African countries in one call, returning source-cited rows with effective and last-confirmed dates

## Facts

- Endpoint: GET https://afriref.dev/v1/compare?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/afriref-compare-cross-country-african-reference-data-9fc3992b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XL-NSN6reR3MrIijJxbRB

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-compare-cross-country-african-reference-data-9fc3992b
```

Example prompt: Compare the VAT rate across Nigeria, Kenya, South Africa, Egypt, and Ghana using Afriref — I need the official values with source citations and effective dates.

## When to prefer this

Use this endpoint when you need to compare one specific government reference series (VAT, policy rate, minimum wage, corporate tax, CPI, etc.) across multiple African countries simultaneously with official source citations. It is the right choice over a general-purpose web search when you need structured, machine-readable, source-cited regulatory data for African markets in a single call. Prefer this over the snapshot endpoint when you only need one series across a targeted list of countries rather than all series for all countries.

## Known failure modes

- Invalid or unsupported series ID returns an error — use GET /catalog to retrieve valid series identifiers
- More than 10 country codes supplied causes a validation error
- Invalid ISO 3166-1 alpha-2 country code returns an error or omits the country
- Country not covered by Afriref's 34-country dataset returns no row or an explicit not-found entry
- Payment failure (x402) prevents the call from completing
- Stale data if a country's official source has not been re-confirmed recently — check last-confirmed date

## How this service works

Compare one government reference series (VAT, policy rate, minimum wage, CPI, corporate tax...) across up to 10 Pan-African countries in one call, each row cited to its official source with effective and last-confirmed dates

## Output

A structured JSON array with one row per country containing the requested series value, effective date, last-confirmed date, and a citation to the official government or central bank source. Up to 10 countries are returned in a single response.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "series",
      "countries"
     ],
     "properties": {
      "series": {
       "type": "string",
       "description": "One series id from GET /catalog, e.g. vat, policy-rate, minimum-wage, corporate-tax"
      },
      "countries": {
       "type": "string",
       "description": "Comma-separated ISO 3166-1 alpha-2 codes on this brand, at most 10"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/afriref-compare-cross-country-african-reference-data-9fc3992b/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)