{"uid":"cap_6yo-mxZp8B29F9P_MfUS6","slug":"afriref-tax-id-vat-validation-920c9efa","name":"Afriref Tax-ID / VAT Validation","description":"Tax-ID / VAT-number validation for Pan-African countries: valid/invalid, normalised form, id type and the reason it failed. Format plus the official check-digit algorithm where the tax authority publishes one; every rule cited to an official source with its date. Pure algorithmic, no registry lookup","url":"https://afriref.dev/v1/taxid/validate?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":["country","id"],"properties":{"id":{"type":"string","description":"The tax ID / VAT number as written (spaces, dots, dashes and the VAT country prefix are accepted)"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code on this brand (see GET /v1/taxid/coverage)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Oqt-7vh5uqdEgC5T3KDXV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates Tax-ID and VAT numbers for Pan-African countries, returning valid/invalid status, normalised form, ID type, and failure reason based on official check-digit algorithms","exampleAgentPrompt":"Can you validate this South African tax ID — 9315141800186 — and tell me if it's correctly formatted and passes the official check-digit algorithm?","exampleUseCases":[{"title":"KYB check for African supplier","prompt":"I'm onboarding a new supplier in Kenya with TIN KRA123456789 — can you validate that tax ID and tell me if it's legitimate and properly formatted?"},{"title":"Invoice VAT number audit","prompt":"We received an invoice from a Nigerian company with TIN 12345678-0001. Can you check whether that tax number is valid for Nigeria and return the normalised form?"},{"title":"Cross-border e-commerce compliance","prompt":"Before we process this order from Egypt, can you verify the customer's tax ID — 123456789 — is a valid Egyptian TIN and tell me what type of ID it is?"}],"resultDescription":"Returns a JSON object containing: a valid/invalid boolean verdict, the normalised canonical form of the tax ID, the identified ID type (e.g. TIN, VAT, etc.), and if invalid, a structured reason for failure — all derived from official check-digit algorithms cited to their source and date, with no live registry lookup.","failureModes":["Unsupported country code returns an error or empty coverage response","Malformed or missing 'id' query parameter returns a 400-level error","Country not yet in coverage returns an error indicating unsupported jurisdiction","Network or payment (x402) failure prevents the call from completing","Edge-case formatting (unusual separators) may cause parsing ambiguity"],"whenToPreferThis":"Use this endpoint when you need algorithmic Tax-ID or VAT number validation for African countries based on official check-digit rules and format specs — especially when you don't need or cannot perform a live government registry lookup. Ideal for KYB/KYC pipelines, invoice validation, onboarding workflows, and compliance checks where speed and cost-efficiency matter. Prefer this over generic global VAT validators if your use case is Pan-African and you need cited, authoritative format rules.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:34:36.863Z","isFirstParty":false,"canonicalSlug":"afriref-tax-id-vat-validation-920c9efa"}