{"uid":"cap_lt5fOULdTfHERlJiaiDdU","slug":"afriref-income-tax-rate-lookup-127ad715","name":"afriref Income Tax Rate Lookup","description":"Statutory income tax on a taxable-income figure: per-bracket workings, effective + marginal rate","url":"https://afriref.dev/v1/answers/income-tax?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["country","taxable_income"],"properties":{"country":{"enum":["ao","bf","bj","bw","cd","cf","cg","ci","cm","dz","eg","et","ga","gh","gq","ke","ls","ma","ml","mu","mz","na","ne","ng","rw","sn","sz","td","tg","tn","tz","ug","za","zm"],"type":"string","description":"ISO country code"},"receipt":{"type":"boolean","description":"Optional. true adds an Ed25519 answer receipt on a paid 200, incluedd in this price. Not a certified extract."},"taxable_income":{"type":"number","description":"Taxable income in the country's local currency, in the schedule's own period basis (annual for most, monthly for CI/UG/ET/CR). NOT gross pay — reliefs are applied before this."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["status","tax","effective_rate","breakdown"],"properties":{"tax":{"type":"number","description":"Statutory income tax on the taxable income"},"status":{"type":"string"},"receipt":{"type":"object","description":"Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key."},"tax_unit":{"type":"object","description":"Present for UVT/UTA/UIT/BPC schedules — the unit's currency value used to scale the bands"},"breakdown":{"type":"array","description":"Per-bracket workings: band, rate, taxable-in-band, tax"},"disclaimer":{"type":"string"},"net_of_tax":{"type":"number"},"provenance":{"type":"object","description":"The statutory instrument the answer rests on: effective_from, last_confirmed, official source URL, notes"},"scope_note":{"type":"string","description":"Explicit boundary: this is tax on taxable income, NOT net take-home (reliefs + social security excluded)"},"marginal_rate":{"type":"number"},"effective_rate":{"type":"number"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AROI_iNzxiJg8aCaK360a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns authoritative income tax reference data for African countries with official source citations, effective dates, and staleness flags","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Compliance check for African payroll","prompt":"I'm processing payroll for employees in Nigeria, Kenya, and Ghana — can you pull the current income tax rates for each country from afriref, including when each rate came into effect and the official source?"},{"title":"Investment due diligence tax research","prompt":"We're evaluating a business expansion into Ethiopia and Rwanda. Can you get me the current income tax rates for both countries, with citations to the government source and whether the data is still fresh?"},{"title":"Automated tax rate validation pipeline","prompt":"Check the income tax rate for Egypt on afriref and tell me the exact value, effective date, and whether it's marked as stale — I need to know if our internal records are out of date."}],"resultDescription":"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.","failureModes":["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)"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:36:47.040Z","isFirstParty":false,"canonicalSlug":"afriref-income-tax-rate-lookup-127ad715"}