{"uid":"cap_Y2fgGonYoK2FV_xioSH9C","slug":"afriref-vat-rate-lookup-1ef9ab1e","name":"AfriRef VAT Rate Lookup","description":"VAT breakdown for an amount: net/tax/gross incl. statutory levy components","url":"https://afriref.dev/v1/answers/vat?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","amount"],"properties":{"band":{"type":"string","description":"Optional. Apply a statutory reduced/zero/super-reduced band instead of the standard rate. Valid keys per country: GET /catalog (vat_bands_available). Omit for the standard rate — we say when we assumed it. Unknown key is refused free with the list."},"mode":{"enum":["add","extract"],"type":"string","description":"add = amount is net, add VAT on top; extract = amount is gross, back the VAT out (default add)"},"amount":{"type":"number","description":"Amount in the country's own currency"},"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."}}},"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","rate","net","tax","gross"],"properties":{"net":{"type":"number"},"tax":{"type":"number"},"rate":{"type":"number","description":"Rate applied (combined effective rate where levies stack)"},"gross":{"type":"number"},"status":{"type":"string"},"receipt":{"type":"object","description":"Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key."},"workings":{"type":"string"},"components":{"type":"array","description":"Per-levy breakdown where the rate is composite (e.g. Ghana VAT + NHIL + GETFund)"},"disclaimer":{"type":"string"},"provenance":{"type":"object","description":"The statutory instrument the answer rests on: effective_from, last_confirmed, official source URL, notes"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0Kx9oUibWwTrw5sEKQ3Ov","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current VAT rate for a specific African country, including effective rate, statutory components, effective date, and source citation.","exampleAgentPrompt":"What is the current VAT rate for Ghana — I need the full breakdown including any stacked levies like NHIL and GETFund, plus when it came into effect and the official source.","exampleUseCases":null,"resultDescription":"A JSON object containing the country code, series ('vat'), the standard VAT rate value with unit, an optional effective_rate where composite levies stack above the base rate, an optional components array breaking down named statutory rates, the effective_from date, last_confirmed date, a source object with name and URL, a stale boolean flag indicating whether the data may be past its expected update cycle, and optional notes.","failureModes":["Unsupported country code (not in enum ci,eg,et,gh,ke,ma,ng,rw,sn,tz,ug) — likely 400 or 404 response","Missing required path parameters country or series — schema validation error","stale:true returned when government has not confirmed data within expected update cycle — treat value with caution","Payment not processed (x402 protocol failure) — endpoint returns 402 before data is served","Network timeout or upstream government source unavailable"],"whenToPreferThis":"Use this endpoint when you need authoritative, sourced VAT rate data for any of the 11 supported African countries (Côte d'Ivoire, Egypt, Ethiopia, Ghana, Kenya, Morocco, Nigeria, Rwanda, Senegal, Tanzania, Uganda) with effective dates and staleness indicators. Prefer this over scraping government websites or using general-purpose LLM knowledge, which may be outdated and lacks structured source citations or composite-rate breakdowns.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:31:45.412Z","isFirstParty":false,"canonicalSlug":"afriref-vat-rate-lookup-1ef9ab1e"}