# afriref — Pan-African government reference data

No account. No API key. No signup. Pay per call with x402.

Human reading this? Start at https://afriref.dev/docs — a copy-paste quickstart. https://afriref.dev/countries
browses every country and value with sources, https://afriref.dev/status is live service state, and
https://afriref.dev/accuracy records where reference data (including ours) has been wrong.

Clean, cited JSON for Pan-African government reference values — central-bank
policy rates, VAT, minimum wages, CPI inflation, corporate & personal income tax,
and public holidays across 34 countries. Every response includes the
official source URL, effective date, last_confirmed date and a stale flag.

## If you sell over x402, start here
Making a cross-border digital sale? Before you settle, know who accounts for the VAT:
- POST https://afriref.dev/v1/vat/determine {seller_country, buyer_country, buyer_type?}
  → place of supply, who accounts for VAT, rate basis, registration trigger — each
    cited to the statute (EU / UK / South Africa). Wallet-only buyer with no tax id →
    treated as B2C and flagged. Out-of-scope country pairs are refused FREE (422),
    never guessed. $0.10/call.

## Sources & licence
Every value is compiled from official government sources — central banks,
finance and labour ministries, revenue authorities, statistical offices — and
each response cites the exact official source URL it was verified against.
Independent service, not affiliated with any government. Verify against the
cited official source before legal or financial use.

## How to call a paid endpoint (x402)
1. Call the endpoint with no payment. You get HTTP 402. The payment challenge is in the
   base64-encoded `payment-required` RESPONSE HEADER (the body is an empty `{}`); decode it to see
   price, asset (USDC), network (eip155:8453 = Base) and pay-to address.
2. Sign the payment with any x402 client — @x402/fetch wraps fetch and does
   steps 1-3 automatically.
3. Retry with the signed X-PAYMENT header. You get HTTP 200 + the data;
   the settlement receipt is returned in the PAYMENT-RESPONSE header.
Bad input is rejected FREE (4xx before the payment gate) — you never pay to fail.
Free, no payment: https://afriref.dev/catalog · https://afriref.dev/llms.txt · https://afriref.dev/openapi.json · public holidays.

## Pricing ladder
- $0.001/call — any single series value or its history
- $0.02 — full regional snapshot (/v1/all) · VAT breakdown · working-days calculator
- $0.05 — minimum-wage compliance check · income-tax computation
- $0.10 — gross-to-net payroll (NG, KE) · cross-border VAT determination · webhook alerts
Licensed tiers / API keys: api@3l-groupconsulting.co.za

## Machine-readable discovery
- x402 resource map: https://afriref.dev/.well-known/x402.json
- Agent card: https://afriref.dev/.well-known/agent.json
- OpenAPI: https://afriref.dev/openapi.json
- MCP server (streamable HTTP): https://afriref.dev/mcp — tools: list_series, get_public_holidays (free); get_series, get_series_history, get_snapshot (paid via x402 or api_key)


## Calendar coverage, and what we refuse
Holiday calendars currently span 2026–2027. Coverage is not uniform and the API tells you so
rather than guessing:
- A range outside a country's covered years is refused FREE (422, `calendar_coverage_exhausted`)
  with the exact covered period. We do not extrapolate: moving feasts, weekend-substitution days
  and ad-hoc proclamations are not derivable from prior years, so counting uncovered days would
  silently treat public holidays as working days.
- For 23 calendars in this region the horizon is PERMANENT, not a backlog
  (`calendar_not_publishable_in_advance`, `permanent: true`). Islamic dates are confirmed by moon
  sighting days ahead; Hebrew and lunisolar festival dates are gazetted annually. Those responses
  name the specific blocking holidays and say what you can do instead — so do not queue a retry
  expecting the year to appear.
- Some entries carry `date: null` with a `pending_window`: the holiday is statutory but the date
  is not yet gazetted. We publish the placeholder rather than inventing a date.
- Holiday entries may carry a `note` explaining how that day behaves in that specific year
  (substitution, transfer, or why it was NOT moved). The `name` field is the stable holiday
  name and is safe to match on across years; `note` is the year-specific commentary.

## What we refuse to answer (and never charge for)
Refusals are the point of this service, not a limitation of it. Every one below is FREE — validated
before the payment gate, so you are never charged for a question we know we cannot answer well:
- Out-of-coverage calendar ranges (above).
- Countries where no single statutory rate exists (e.g. a VAT regime mid-transition) — refused
  with the explanation rather than collapsed to one misleading number.
- Out-of-scope country pairs on /v1/vat/determine.
- Settlement dates where we hold no verified convention for the market, or where the convention
  was not in force on the trade date — `no_verified_convention` /
  `convention_not_in_force_on_trade_date`, never a guessed cycle.
Some series are deliberately ABSENT for the same reason: where a rate could not be verified against
its own statute we omit the series rather than estimate it, and the endpoint 404s.

## Which of our numbers we actually read (`confidence`)
Every series carries a machine-readable `confidence`, and the catalog can be filtered on it.
This is unusual and it is deliberate: a value's weakest point is usually not the number but how it
was obtained, and that belongs in a field rather than buried in a paragraph of notes.
- `primary`   — no verification limitation is recorded. NOTE this is the ABSENCE of a known problem,
                not a fresh re-verification: it says the value was taken from the source cited and
                nothing since has flagged otherwise.
- `secondary` — corroborated across sources, but the primary instrument was NOT read. Nearly always
                because the publishing host blocks automated access (several government portals 403
                bots outright, or serve a JavaScript viewer with no extractable text).
- `attested`  — NO primary source is publicly available to anyone. The value rests on an official
                statement about the instrument rather than the instrument itself. Two series today:
                Botswana does not publish Statutory Instruments online at all, and the Central
                African Republic decree appears on no government site, ILO NATLEX or any gazette.
- `derived`   — computed from another series we hold, not read from any document.
- Filter: GET https://afriref.dev/catalog?confidence=primary (free; comma-separated levels accepted)
Where confidence is not `primary`, `confidence_note` gives the specific limitation in our own words.

## Point-in-time reads (?as_at=YYYY-MM-DD)
Any series accepts `?as_at=` and returns the value that was IN FORCE on that date, not today's.
Back-dated payroll recalculation and prior-year filings need this, and picking the right row out of a
full history yourself is a derivation that fails quietly — the wrong row still looks plausible.
- GET https://afriref.dev/v1/{country}/{series}?as_at=2023-06-15
The answer carries `as_at`, `point_in_time: true` and `superseded_on`, so a historical value can never
be mistaken for a live one. IT REFUSES RATHER THAN FALLING BACK: ask for a date before the earliest
value we hold, or one after a value lapsed with no recorded successor, and you get a FREE 422 naming
the earliest date we do hold. Returning the current value for a 2023 question would be the wrong
number in the right shape. Bad dates are rejected free too, before the payment gate.

## Provenance — the evidence behind every citation
- GET https://afriref.dev/provenance (free) — fleet-wide snapshot coverage
- GET https://afriref.dev/provenance/{country}/{series} (free) — the sources behind one endpoint
Citing a source is a claim. We fetch each cited document, record a sha256 over the exact bytes, and
re-check daily, so you can see WHEN we verified against it and whether it has CHANGED since. Two
things surface that a last-verified date cannot: rot (the document no longer resolves) and drift (it
still resolves but its bytes changed, meaning the page you would follow no longer says what we read).
Failure states are distinguished honestly — `gone` (404/410) is not the same as
`blocked_to_automation` (the host refuses bots; a person can still open it), and we do not claim a
live source is dead. We publish the fingerprint, not the mirrored document.

## Accuracy record
- https://afriref.dev/accuracy — documented cases where widely-published reference values are wrong, each traced
  to the governing instrument, AND every error we have found in our own served data. The second half
  is the point: a vendor publishing only other people's mistakes is marketing.

## Human-readable pages
- https://afriref.dev/countries — every country held
- https://afriref.dev/{country} — e.g. /za — all series with values, sources and freshness
- https://afriref.dev/{country}/{series} — e.g. /za/vat — value, what it means, earlier values, provenance
- https://afriref.dev/sitemap.xml

## Series
- GET /v1/ao/policy-rate — Angola: Taxa BNA (BNA policy rate)
- GET /v1/ao/vat — Angola: IVA taxa geral (standard VAT rate)
- GET /v1/ao/minimum-wage — Angola: Salário Mínimo Nacional (SMN)
- GET /v1/ao/public-holidays — Angola: Feriados nacionais (free)
- GET /v1/ao/cpi — Angola: CPI inflation (year-on-year, national)
- GET /v1/ao/corporate-tax — Angola: Imposto Industrial — taxa geral
- GET /v1/ao/income-tax — Angola: IRT — Grupo A employment income brackets
- GET /v1/bf/policy-rate — Burkina Faso: Policy rate (BCEAO taux minimum de soumission)
- GET /v1/bf/vat — Burkina Faso: Value added tax (Taxe sur la valeur ajoutee - TVA)
- GET /v1/bf/minimum-wage — Burkina Faso: Minimum wage (SMIG - salaire minimum interprofessionnel garanti)
- GET /v1/bf/public-holidays — Burkina Faso: Public holidays (free)
- GET /v1/bf/cpi — Burkina Faso: Consumer price inflation (IHPC, glissement annuel)
- GET /v1/bf/corporate-tax — Burkina Faso: Corporate income tax (Impot sur les societes - IS)
- GET /v1/bf/income-tax — Burkina Faso: Personal income tax on employment income (IUTS)
- GET /v1/bj/policy-rate — Benin: Policy rate (BCEAO minimum bid rate)
- GET /v1/bj/vat — Benin: Value-added tax (TVA) standard rate
- GET /v1/bj/minimum-wage — Benin: Minimum wage (SMIG)
- GET /v1/bj/public-holidays — Benin: Public holidays (free)
- GET /v1/bj/cpi — Benin: CPI inflation (IHPC, year-on-year)
- GET /v1/bj/corporate-tax — Benin: Corporate income tax (IS) standard rate
- GET /v1/bj/income-tax — Benin: Personal income tax on salaries (ITS)
- GET /v1/bw/policy-rate — Botswana: Monetary Policy Rate (MoPR)
- GET /v1/bw/vat — Botswana: VAT standard rate
- GET /v1/bw/minimum-wage — Botswana: Minimum wage (general hourly rate, scheduled trades)
- GET /v1/bw/public-holidays — Botswana: Public holidays (free)
- GET /v1/bw/cpi — Botswana: CPI inflation (year-on-year)
- GET /v1/bw/corporate-tax — Botswana: Corporate income tax rate
- GET /v1/bw/income-tax — Botswana: Personal income tax brackets (resident individuals)
- GET /v1/cd/policy-rate — Democratic Republic of the Congo: BCC taux directeur (policy rate)
- GET /v1/cd/vat — Democratic Republic of the Congo: TVA taux normal (standard VAT rate)
- GET /v1/cd/minimum-wage — Democratic Republic of the Congo: SMIG — salaire minimum interprofessionnel garanti (taux journalier)
- GET /v1/cd/public-holidays — Democratic Republic of the Congo: Public holidays (free)
- GET /v1/cd/cpi — Democratic Republic of the Congo: Inflation en glissement annuel (year-on-year CPI inflation)
- GET /v1/cd/corporate-tax — Democratic Republic of the Congo: Impôt sur les sociétés (IS) — standard rate
- GET /v1/cd/income-tax — Democratic Republic of the Congo: IRPP — barème progressif (personal income tax bands)
- GET /v1/cf/policy-rate — Central African Republic: Policy interest rate (BEAC TIAO)
- GET /v1/cf/vat — Central African Republic: Value added tax (TVA) - standard rate
- GET /v1/cf/minimum-wage — Central African Republic: Guaranteed interprofessional minimum wage (SMIG)
- GET /v1/cf/public-holidays — Central African Republic: Public holidays (free)
- GET /v1/cf/cpi — Central African Republic: Consumer price inflation (IHPC)
- GET /v1/cf/corporate-tax — Central African Republic: Corporate income tax (impot sur les societes)
- GET /v1/cf/income-tax — Central African Republic: Personal income tax (IRPP) - salary schedule
- GET /v1/cg/policy-rate — Republic of the Congo: Policy rate (BEAC TIAO)
- GET /v1/cg/vat — Republic of the Congo: Value added tax (TVA)
- GET /v1/cg/minimum-wage — Republic of the Congo: Minimum wage (SMIG)
- GET /v1/cg/public-holidays — Republic of the Congo: Public holidays (free)
- GET /v1/cg/cpi — Republic of the Congo: Consumer price inflation (INHPC)
- GET /v1/cg/corporate-tax — Republic of the Congo: Corporate income tax (impot sur les societes)
- GET /v1/cg/income-tax — Republic of the Congo: Personal income tax (IRPP / impot sur les traitements et salaires)
- GET /v1/ci/policy-rate — Côte d'Ivoire: BCEAO main policy rate (taux minimum de soumission)
- GET /v1/ci/vat — Côte d'Ivoire: VAT standard rate (TVA)
- GET /v1/ci/minimum-wage — Côte d'Ivoire: Minimum wage (SMIG)
- GET /v1/ci/public-holidays — Côte d'Ivoire: Public holidays (free)
- GET /v1/ci/cpi — Côte d'Ivoire: CPI inflation (year-on-year)
- GET /v1/ci/corporate-tax — Côte d'Ivoire: Corporate income tax rate
- GET /v1/ci/income-tax — Côte d'Ivoire: Personal income tax brackets
- GET /v1/cm/policy-rate — Cameroon: Policy interest rate (BEAC TIAO)
- GET /v1/cm/vat — Cameroon: Value added tax (TVA)
- GET /v1/cm/minimum-wage — Cameroon: Guaranteed interprofessional minimum wage (SMIG)
- GET /v1/cm/public-holidays — Cameroon: Public holidays (free)
- GET /v1/cm/cpi — Cameroon: Consumer price inflation (year-on-year)
- GET /v1/cm/corporate-tax — Cameroon: Corporate income tax (Impot sur les Societes)
- GET /v1/cm/income-tax — Cameroon: Personal income tax (IRPP) - salary schedule
- GET /v1/dz/policy-rate — Algeria: Banque d'Algérie policy rate (taux directeur)
- GET /v1/dz/vat — Algeria: TVA standard rate (taux normal)
- GET /v1/dz/minimum-wage — Algeria: SNMG — Salaire National Minimum Garanti
- GET /v1/dz/public-holidays — Algeria: Public holidays (fêtes légales) (free)
- GET /v1/dz/cpi — Algeria: CPI inflation (year-on-year, national index)
- GET /v1/dz/corporate-tax — Algeria: IBS — Impôt sur les Bénéfices des Sociétés (general rate)
- GET /v1/dz/income-tax — Algeria: IRG — Impôt sur le Revenu Global, progressive scale
- GET /v1/eg/policy-rate — Egypt: Central Bank of Egypt overnight deposit rate
- GET /v1/eg/vat — Egypt: VAT standard rate
- GET /v1/eg/minimum-wage — Egypt: Private-sector minimum wage
- GET /v1/eg/public-holidays — Egypt: Public holidays (free)
- GET /v1/eg/cpi — Egypt: CPI inflation (year-on-year)
- GET /v1/eg/corporate-tax — Egypt: Corporate income tax rate
- GET /v1/eg/income-tax — Egypt: Personal income tax brackets
- GET /v1/eg/fx-reference — Egypt: CBE official exchange rates (buy/sell)
- GET /v1/et/policy-rate — Ethiopia: NBE National Bank Rate (policy rate)
- GET /v1/et/vat — Ethiopia: VAT standard rate
- GET /v1/et/minimum-wage — Ethiopia: National minimum wage (none in force)
- GET /v1/et/public-holidays — Ethiopia: Public holidays (free)
- GET /v1/et/cpi — Ethiopia: CPI inflation (year-on-year)
- GET /v1/et/corporate-tax — Ethiopia: Corporate income tax rate
- GET /v1/et/income-tax — Ethiopia: Personal income tax brackets
- GET /v1/ga/policy-rate — Gabon: BEAC policy rate (TIAO)
- GET /v1/ga/vat — Gabon: Value-added tax (TVA)
- GET /v1/ga/minimum-wage — Gabon: Guaranteed interprofessional minimum wage (SMIG)
- GET /v1/ga/public-holidays — Gabon: Public holidays (free)
- GET /v1/ga/cpi — Gabon: Consumer price inflation (IHPC, year-on-year)
- GET /v1/ga/corporate-tax — Gabon: Corporate income tax (Impot sur les Societes)
- GET /v1/ga/income-tax — Gabon: Personal income tax (IRPP)
- GET /v1/gh/policy-rate — Ghana: Bank of Ghana monetary policy rate
- GET /v1/gh/vat — Ghana: VAT standard rate
- GET /v1/gh/minimum-wage — Ghana: National daily minimum wage
- GET /v1/gh/public-holidays — Ghana: Public holidays (free)
- GET /v1/gh/cpi — Ghana: CPI inflation (year-on-year)
- GET /v1/gh/corporate-tax — Ghana: Corporate income tax rate
- GET /v1/gh/income-tax — Ghana: Personal income tax brackets
- GET /v1/gq/policy-rate — Equatorial Guinea: Policy interest rate (BEAC TIAO)
- GET /v1/gq/vat — Equatorial Guinea: Value added tax (Impuesto sobre el Valor Anadido, IVA) - standard rate
- GET /v1/gq/minimum-wage — Equatorial Guinea: Salario minimo interprofesional (SMI)
- GET /v1/gq/public-holidays — Equatorial Guinea: Public holidays (free)
- GET /v1/gq/cpi — Equatorial Guinea: Consumer price inflation (year-on-year)
- GET /v1/gq/corporate-tax — Equatorial Guinea: Corporate income tax (Impuesto sobre Sociedades)
- GET /v1/gq/income-tax — Equatorial Guinea: Personal income tax (Impuesto sobre Sueldos y Salarios / IRPF)
- GET /v1/ke/policy-rate — Kenya: CBK central bank rate
- GET /v1/ke/vat — Kenya: VAT standard rate
- GET /v1/ke/minimum-wage — Kenya: Minimum wage (lowest general-order rate)
- GET /v1/ke/public-holidays — Kenya: Public holidays (free)
- GET /v1/ke/cpi — Kenya: CPI inflation (year-on-year)
- GET /v1/ke/corporate-tax — Kenya: Corporate income tax rate
- GET /v1/ke/income-tax — Kenya: Personal income tax brackets
- GET /v1/ke/fx-reference — Kenya: CBK indicative exchange rates (trade-weighted average)
- GET /v1/ke/social-contributions — Kenya: Statutory payroll contributions (employee)
- GET /v1/ke/vat-registration-threshold — Kenya: VAT registration threshold
- GET /v1/ls/policy-rate — Lesotho: CBL Rate (Central Bank of Lesotho policy rate)
- GET /v1/ls/vat — Lesotho: VAT standard rate
- GET /v1/ls/minimum-wage — Lesotho: Sectoral minimum wages (basic minimum wages by sector and category)
- GET /v1/ls/public-holidays — Lesotho: Public holidays (free)
- GET /v1/ls/cpi — Lesotho: CPI inflation (year-on-year)
- GET /v1/ls/corporate-tax — Lesotho: Company income tax rate (standard, non-manufacturing)
- GET /v1/ls/income-tax — Lesotho: Personal income tax rates, threshold and credit
- GET /v1/ma/policy-rate — Morocco: Bank Al-Maghrib key policy rate (taux directeur)
- GET /v1/ma/vat — Morocco: VAT standard rate (TVA taux normal)
- GET /v1/ma/minimum-wage — Morocco: Minimum wage — SMIG (non-agricultural) and SMAG (agricultural)
- GET /v1/ma/public-holidays — Morocco: Public holidays (free)
- GET /v1/ma/cpi — Morocco: CPI inflation (year-on-year)
- GET /v1/ma/corporate-tax — Morocco: Corporate income tax rate
- GET /v1/ma/income-tax — Morocco: Personal income tax brackets
- GET /v1/ml/policy-rate — Mali: BCEAO Minimum Bid Rate (taux minimum de soumission)
- GET /v1/ml/vat — Mali: Taxe sur la Valeur Ajoutee (TVA) - standard rate
- GET /v1/ml/minimum-wage — Mali: Salaire Minimum Interprofessionnel Garanti (SMIG)
- GET /v1/ml/public-holidays — Mali: Public Holidays (Fetes legales) (free)
- GET /v1/ml/cpi — Mali: Indice Harmonise des Prix a la Consommation (IHPC) - year-on-year inflation
- GET /v1/ml/corporate-tax — Mali: Impot sur les Societes (IS) - standard rate
- GET /v1/ml/income-tax — Mali: Impot sur les Traitements et Salaires (ITS) - progressive schedule
- GET /v1/mu/policy-rate — Mauritius: Bank of Mauritius Key Rate
- GET /v1/mu/vat — Mauritius: VAT standard rate
- GET /v1/mu/minimum-wage — Mauritius: National Minimum Wage (full-time worker, monthly)
- GET /v1/mu/public-holidays — Mauritius: Public holidays (free)
- GET /v1/mu/cpi — Mauritius: CPI inflation (year-on-year)
- GET /v1/mu/corporate-tax — Mauritius: Corporate income tax rate
- GET /v1/mu/income-tax — Mauritius: Personal income tax bands
- GET /v1/mz/policy-rate — Mozambique: MIMO rate (Taxa de Juro de Política Monetária)
- GET /v1/mz/vat — Mozambique: IVA standard rate
- GET /v1/mz/minimum-wage — Mozambique: Sectoral minimum wages (salários mínimos por sector)
- GET /v1/mz/public-holidays — Mozambique: Public holidays (free)
- GET /v1/mz/cpi — Mozambique: CPI inflation (year-on-year)
- GET /v1/mz/corporate-tax — Mozambique: IRPC standard rate
- GET /v1/mz/income-tax — Mozambique: IRPS progressive rate schedule
- GET /v1/na/policy-rate — Namibia: Bank of Namibia Repo rate
- GET /v1/na/vat — Namibia: VAT standard rate
- GET /v1/na/minimum-wage — Namibia: National minimum wage
- GET /v1/na/public-holidays — Namibia: Public holidays (free)
- GET /v1/na/cpi — Namibia: CPI inflation (year-on-year)
- GET /v1/na/corporate-tax — Namibia: Corporate income tax rate (non-mining)
- GET /v1/na/income-tax — Namibia: Personal income tax brackets
- GET /v1/ne/policy-rate — Niger: BCEAO minimum bid rate (taux minimum de soumission)
- GET /v1/ne/vat — Niger: Taxe sur la valeur ajoutée (TVA) — standard rate
- GET /v1/ne/minimum-wage — Niger: Salaire minimum interprofessionnel garanti (SMIG)
- GET /v1/ne/public-holidays — Niger: Public holidays (jours fériés, chômés et payés) (free)
- GET /v1/ne/cpi — Niger: Inflation (IHPC, glissement annuel)
- GET /v1/ne/corporate-tax — Niger: Impôt sur les bénéfices (ISB)
- GET /v1/ne/income-tax — Niger: Impôt sur les traitements et salaires (ITS)
- GET /v1/ng/policy-rate — Nigeria: CBN monetary policy rate
- GET /v1/ng/vat — Nigeria: VAT standard rate
- GET /v1/ng/minimum-wage — Nigeria: National minimum wage
- GET /v1/ng/public-holidays — Nigeria: Public holidays (free)
- GET /v1/ng/cpi — Nigeria: CPI inflation (year-on-year)
- GET /v1/ng/corporate-tax — Nigeria: Corporate income tax rate
- GET /v1/ng/income-tax — Nigeria: Personal income tax brackets
- GET /v1/ng/fx-reference — Nigeria: CBN official exchange rate (NFEM volume-weighted average)
- GET /v1/ng/social-contributions — Nigeria: Statutory payroll contributions (employee)
- GET /v1/rw/policy-rate — Rwanda: National Bank of Rwanda central bank rate
- GET /v1/rw/vat — Rwanda: VAT standard rate
- GET /v1/rw/minimum-wage — Rwanda: Statutory minimum wage (none in force)
- GET /v1/rw/public-holidays — Rwanda: Public holidays (free)
- GET /v1/rw/cpi — Rwanda: CPI inflation (year-on-year)
- GET /v1/rw/corporate-tax — Rwanda: Corporate income tax rate
- GET /v1/rw/income-tax — Rwanda: Personal income tax brackets
- GET /v1/sn/policy-rate — Senegal: BCEAO main policy rate (taux minimum de soumission aux appels d'offres)
- GET /v1/sn/vat — Senegal: VAT standard rate (TVA)
- GET /v1/sn/minimum-wage — Senegal: Minimum wage (SMIG / SMAG)
- GET /v1/sn/public-holidays — Senegal: Public holidays (free)
- GET /v1/sn/cpi — Senegal: CPI inflation (year-on-year)
- GET /v1/sn/corporate-tax — Senegal: Corporate income tax rate
- GET /v1/sn/income-tax — Senegal: Personal income tax brackets
- GET /v1/sz/policy-rate — Eswatini: Central Bank of Eswatini discount rate
- GET /v1/sz/vat — Eswatini: VAT standard rate
- GET /v1/sz/minimum-wage — Eswatini: Sectoral minimum wages (Regulation of Wages Orders)
- GET /v1/sz/public-holidays — Eswatini: Public holidays (free)
- GET /v1/sz/cpi — Eswatini: CPI inflation (year-on-year)
- GET /v1/sz/corporate-tax — Eswatini: Company income tax rate
- GET /v1/sz/income-tax — Eswatini: Personal income tax bands
- GET /v1/td/policy-rate — Chad: Policy interest rate (BEAC TIAO)
- GET /v1/td/vat — Chad: Value added tax (TVA) standard rate
- GET /v1/td/minimum-wage — Chad: Guaranteed interprofessional minimum wage (SMIG)
- GET /v1/td/public-holidays — Chad: Public holidays (free)
- GET /v1/td/cpi — Chad: Consumer price inflation (INHPC, year-on-year)
- GET /v1/td/corporate-tax — Chad: Corporate income tax (Impot sur les Societes)
- GET /v1/td/income-tax — Chad: Personal income tax (IRPP) - work income schedule
- GET /v1/tg/policy-rate — Togo: Policy Rate (BCEAO taux minimum de soumission)
- GET /v1/tg/vat — Togo: Value Added Tax (Taxe sur la Valeur Ajoutee - TVA)
- GET /v1/tg/minimum-wage — Togo: Minimum Wage (SMIG - Salaire Minimum Interprofessionnel Garanti)
- GET /v1/tg/public-holidays — Togo: Public Holidays (free)
- GET /v1/tg/cpi — Togo: Consumer Price Inflation (IHPC - Indice Harmonise des Prix a la Consommation)
- GET /v1/tg/corporate-tax — Togo: Corporate Income Tax (Impot sur les Societes - IS)
- GET /v1/tg/income-tax — Togo: Personal Income Tax (Impot sur le Revenu des Personnes Physiques - IRPP)
- GET /v1/tn/policy-rate — Tunisia: BCT key policy rate (taux directeur)
- GET /v1/tn/vat — Tunisia: TVA standard rate
- GET /v1/tn/minimum-wage — Tunisia: SMIG — guaranteed inter-professional minimum wage (48-hour week, monthly)
- GET /v1/tn/public-holidays — Tunisia: Public holidays (free)
- GET /v1/tn/cpi — Tunisia: CPI inflation (year-on-year)
- GET /v1/tn/corporate-tax — Tunisia: Corporate income tax rate (IS) — general rate
- GET /v1/tn/income-tax — Tunisia: Personal income tax brackets (IRPP)
- GET /v1/tz/policy-rate — Tanzania: Bank of Tanzania central bank rate
- GET /v1/tz/vat — Tanzania: VAT standard rate
- GET /v1/tz/minimum-wage — Tanzania: Private-sector minimum wage (lowest sectoral rate)
- GET /v1/tz/public-holidays — Tanzania: Public holidays (free)
- GET /v1/tz/cpi — Tanzania: CPI inflation (year-on-year)
- GET /v1/tz/corporate-tax — Tanzania: Corporate income tax rate
- GET /v1/tz/income-tax — Tanzania: Personal income tax brackets
- GET /v1/ug/policy-rate — Uganda: Bank of Uganda central bank rate
- GET /v1/ug/vat — Uganda: VAT standard rate
- GET /v1/ug/minimum-wage — Uganda: National minimum wage (statutory, archaic)
- GET /v1/ug/public-holidays — Uganda: Public holidays (free)
- GET /v1/ug/cpi — Uganda: CPI inflation (year-on-year)
- GET /v1/ug/corporate-tax — Uganda: Corporate income tax rate
- GET /v1/ug/income-tax — Uganda: Personal income tax brackets
- GET /v1/za/policy-rate — South Africa: SARB repurchase (repo) rate
- GET /v1/za/vat — South Africa: VAT standard rate
- GET /v1/za/minimum-wage — South Africa: National Minimum Wage (hourly)
- GET /v1/za/public-holidays — South Africa: Public holidays (free)
- GET /v1/za/cpi — South Africa: CPI inflation (headline, year-on-year)
- GET /v1/za/corporate-tax — South Africa: Corporate income tax rate
- GET /v1/za/income-tax — South Africa: Personal income tax brackets
- GET /v1/za/fx-reference — South Africa: SARB rand exchange rates (official reference)
- GET /v1/za/statutory-interest — South Africa: Prescribed rate of interest
- GET /v1/za/vat-registration-threshold — South Africa: VAT registration threshold
- GET /v1/za/withholding-tax — South Africa: Withholding tax rates
- GET /v1/zm/policy-rate — Zambia: Bank of Zambia Policy Rate
- GET /v1/zm/vat — Zambia: VAT standard rate
- GET /v1/zm/minimum-wage — Zambia: Statutory minimum wages by category (no single national rate)
- GET /v1/zm/public-holidays — Zambia: Public holidays (free)
- GET /v1/zm/cpi — Zambia: CPI inflation (year-on-year)
- GET /v1/zm/corporate-tax — Zambia: Company income tax standard rate
- GET /v1/zm/income-tax — Zambia: Personal income tax (PAYE) bands

History: GET /v1/{country}/{series}/history?from=YYYY-MM-DD&to=YYYY-MM-DD — e.g. GET /v1/ao/policy-rate/history?from=2026-01-01
Changes + freshness (FREE, unmetered): GET /v1/changes?since=YYYY-MM-DD — what changed, plus how many of our 248 series were re-verified against their official source in the last 1/7/30/90 days, and which one has gone longest without a check. `since` is optional (defaults to 30 days).

## Answers (computed verdicts, POST JSON)
- POST /v1/answers/wage-check {country, amount, period, schedule?} — at/above/below the statutory minimum? Pass "schedule" to be measured against a sectoral/zonal/grade floor instead of the general one (Kenya 55, South Africa 24); omit it and we say so, because "above the national floor" is not "compliant". Keys: GET /catalog ($0.05)
- POST /v1/answers/vat {country, amount, mode?, band?} — net/tax/gross breakdown incl. levy components. Pass "band" for a statutory reduced/zero/super-reduced rate; we publish what each band covers in the authority's own words but do not classify supplies into bands. Keys: GET /catalog ($0.02)
- POST /v1/answers/working-days {country, from, to} — working days, holidays hit, next working day ($0.02)
- POST /v1/answers/income-tax {country, taxable_income} — statutory income tax + per-bracket workings ($0.05)
- POST /v1/answers/payroll {country, gross, period?} — gross-to-net take-home: PAYE + statutory deductions, Nigeria & Kenya ($0.10)
- POST /v1/answers/settlement-date {trade_date, calendars[], business_days | market + instrument_class} — settlement/value date: T+n business days across one or more national statutory calendars intersected, with a per-day trail, each calendar's basis and source, and the market cycle cited to its primary instrument where we hold one ($0.05). Cited cycles and what we deliberately refuse to cite: GET /settlement-conventions (free)
- POST /v1/vat/determine {seller_country, buyer_country, buyer_type?} — cross-border VAT treatment of a digital-services sale: place of supply, who accounts, rate basis, registration trigger, with the applied rule cited to the statute. EU, UK, South Africa; unknown buyer → B2C-default, flagged; out-of-scope pairs refused FREE (422), never guessed, never charged ($0.10)