afrirefCountries › API

Cross-border VAT treatment of a digital sale

For a seller making a cross-border digital-services sale: place of supply, who accounts for the VAT, the rate basis and the registration trigger, each cited to the statute. Handles the wallet-only, unidentified-buyer case that x402 settlements produce. Country pairs outside the verified ruleset are refused free.

This endpoint takes a POST, because it computes an answer from values you supply — there is nothing to fetch at this URL. You are seeing this page because your browser asked for HTML; an API client gets a 405 with the same information as JSON.

Call it

curl -X POST https://afriref.dev/v1/vat/determine \
  -H 'content-type: application/json' \
  -d '{"seller_country":"za","buyer_country":"de","buyer_type":"business"}'

Body fields: seller_country, buyer_country, buyer_type

Paid per call over x402 (USDC on Base) — no key, no signup. Invalid input and questions we cannot answer well are refused free, before the payment gate: you never pay to fail.

What sits behind the answer

Every computed answer is arithmetic on cited reference data. The underlying values each carry their official source, an effective date and a last-verified date, and each declares how it was obtained — see the country pages and source provenance. Results are labelled basis: "computed" and are not tax, legal or financial advice.

Free to inspect

/catalog — every country and series held · /llms.txt — endpoints, prices and example bodies · /openapi.json · /accuracy — where reference data is wrong, including ours