{"uid":"cap_31rEN2vg2-cAHotcvXTxa","slug":"afriref-dev-vat-cross-border-digital-services-determinator-c899d5e3","name":"afriref.dev VAT Cross-Border Digital Services Determinator","description":"Cross-border VAT treatment for a digital-services sale: place of supply, who accounts, rate basis, registration trigger — the applied rule cited to the statute (EU, UK, South Africa)","url":"https://afriref.dev/v1/vat/determine?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":["seller_country","buyer_country"],"properties":{"receipt":{"type":"boolean","description":"Optional. true adds an Ed25519 answer receipt on a paid 200, incluedd in this price. Not a certified extract."},"buyer_type":{"enum":["B2B","B2C","unknown"],"type":"string","description":"unknown (default) = buyer identified only by wallet address — treated as B2C under default rules and explicitly flagged in the response"},"buyer_country":{"type":"string","description":"Buyer's country, ISO 3166-1 alpha-2"},"seller_country":{"type":"string","description":"Seller's country, ISO 3166-1 alpha-2 (EL accepted for Greece, UK for United Kingdom)"}}},"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","workings","disclaimer"],"properties":{"rule":{"type":"object","description":"The applied rule: place_of_supply, who_accounts_for_vat, rate_basis, registration_or_threshold, reporting, statutory citation, notes"},"status":{"enum":["ok"],"type":"string","description":"Paid responses always carry a matched rule — out-of-scope pairs are refused free (422) before payment"},"receipt":{"type":"object","description":"Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key."},"workings":{"type":"array","description":"The classification reasoning that selected the rule"},"vida_flag":{"type":"string","description":"Forthcoming EU ViDA changes affecting these rules (2027/2028/2030)"},"disclaimer":{"type":"string"},"buyer_identity_flag":{"type":"string","description":"Present when the buyer was unidentified: records the B2C-default assumption"},"eservices_definition":{"type":"object","description":"What counts as an electronically-supplied service, with citation"},"destination_liability":{"type":"object","description":"Present when a supplier-side treatment (e.g. SA zero-rating) coexists with a verified destination-country VAT obligation — carries the companion rule"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_z_Tt2nQJGO3-gqwrOH-JQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Determines cross-border VAT treatment for a digital-services sale: place of supply, who accounts for the tax, applicable rate basis, and registration trigger — with the applied rule cited to the statute (EU, UK, South Africa)","exampleAgentPrompt":"We're a South African SaaS company selling subscriptions to individual consumers in the UK and Germany — can you determine the VAT treatment for each sale, including who accounts for the tax, what rate basis applies, and which statute we're citing?","exampleUseCases":[{"title":"SaaS startup VAT registration check","prompt":"We're a South African startup selling cloud software to UK consumers. At what revenue threshold do we trigger a VAT registration obligation in the UK, and which statutory rule applies?"},{"title":"EU B2B reverse charge determination","prompt":"My UK company is selling digital analytics services to a German GmbH — does reverse charge apply, who accounts for the VAT, and can you cite the EU directive provision that governs this?"},{"title":"Cross-border digital marketplace compliance","prompt":"Our platform sells digital content to consumers in both South Africa and the EU. For a sale from an EU supplier to a South African consumer, what is the place of supply, who owes the VAT, and what rate basis applies under South African law?"}],"resultDescription":"Returns the VAT treatment determination including: place of supply ruling, which party is responsible for accounting for the VAT (supplier or customer via reverse charge), the applicable rate basis, whether a registration threshold has been triggered, and the specific statutory citation (EU directive article, UK VAT Act section, or South African VAT Act provision) that underpins the ruling.","failureModes":["Unsupported country pair (only EU, UK, South Africa jurisdictions covered) — returns 422 with unsupported jurisdiction error","Missing required fields (supplier country, customer country, customer type, service type) — returns 400 validation error","Ambiguous service classification not mappable to digital services category — returns 422 with classification error","Outdated statutory rate if legislation changed after last data refresh — stale data risk","Transaction date outside supported range — returns 400 with date range error"],"whenToPreferThis":"Prefer this endpoint when you need a legally-cited, rule-based VAT determination for cross-border digital services specifically involving EU, UK, or South Africa jurisdictions. It is purpose-built for the Africa-EU-UK triangle and cites the actual statute, making it suitable for compliance documentation rather than just estimation. Choose alternatives for purely domestic VAT calculations, for jurisdictions outside this triangle, or for goods (non-digital) VAT treatment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T19:19:52.496Z","isFirstParty":false,"canonicalSlug":"afriref-dev-vat-cross-border-digital-services-determinator-c899d5e3"}