# afriref Income Tax Rate Lookup

> afriref Income Tax Rate Lookup is a paid API for AI agents from afriref.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns authoritative income tax reference data for African countries with official source citations, effective dates, and staleness flags

## Facts

- Endpoint: POST https://afriref.dev/v1/answers/income-tax
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/afriref-income-tax-rate-lookup-127ad715
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lt5fOULdTfHERlJiaiDdU

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-income-tax-rate-lookup-127ad715 -d '<json body>'
```

Example prompt: What is the current income tax rate in Kenya according to afriref — I need the official rate with its source citation and effective date for a compliance report.

## When to prefer this

Choose this endpoint when you need authoritative, citation-backed income tax rates for one of the 11 supported African countries (CI, EG, ET, GH, KE, MA, NG, RW, SN, TZ, UG) and require an official source reference, effective date, and freshness indicator for compliance, financial modeling, or regulatory reporting. Prefer this over scraping government websites or using general tax databases when you need structured JSON with provenance metadata and staleness detection baked in.

## Known failure modes

- Unsupported country code returns an error or empty response — only 11 African countries are covered
- Data may be flagged as stale if the official source hasn't been re-confirmed recently
- Rate may reflect a union-wide figure rather than a country-specific one (as seen with BCEAO/UEMOA members)
- Network or payment (x402) failures result in no response
- Ambiguous series name may return unexpected data type (e.g. policy-rate vs income-tax)

## How this service works

Statutory income tax on a taxable-income figure: per-bracket workings, effective + marginal rate

## Output

A JSON object containing the income tax rate value and unit (e.g. percent), the country code, series identifier, effective_from date, last_confirmed date, a staleness boolean flag, detailed notes (including regional nuances or rate structure), a disclaimer about independent status, and a source object with the official government or regulatory URL and name.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/afriref-income-tax-rate-lookup-127ad715/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)
