Look up EU VAT categories for any country via a pay-per-call MPP endpoint.
What it does
The VAT Categories endpoint is part of the Abstract VAT service exposed through the Locus MPP (Micropayment Protocol) gateway. Given an ISO 3166-1 alpha-2 country code, it returns the VAT categories applicable in that EU member state. This is useful for e-commerce platforms, tax compliance tools, and invoicing systems that need to determine which VAT rate categories (standard, reduced, super-reduced, etc.) apply in a given country.
The endpoint accepts a POST request with a JSON body containing a required `country_code` field. Payment is settled per-call via the Tempo method on pathUSD at $0.006 per request. The broader Abstract VAT service also offers VAT number validation and VAT amount calculation endpoints at the same per-call price.
Note: the probe returned 404 on HEAD and GET because this endpoint only accepts POST requests. The OpenAPI spec clearly defines it as a POST endpoint, and the 404 on other methods does not indicate the service is down. Documentation is available at the Abstract API VAT reference and a Locus-specific markdown file.
Capabilities
Use cases
- —Determine applicable VAT rate categories for a specific EU country during checkout
- —Build tax-compliant invoicing that maps products to correct VAT categories
- —Populate VAT category dropdowns in e-commerce admin panels
- —Automate EU tax reporting by programmatically fetching category structures
Fit
Best for
- —E-commerce platforms selling into EU markets
- —Tax compliance and invoicing software
- —Agents that need real-time EU VAT category data without managing API keys
Not for
- —Non-EU tax lookups (US sales tax, etc.)
- —High-volume batch processing where per-call pricing may add up
- —VAT filing or submission to tax authorities
Quick start
curl -X POST https://abstract-vat.mpp.paywithlocus.com/abstract-vat/categories \
-H "Content-Type: application/json" \
-d '{"country_code": "DE"}'Example
Request
{
"country_code": "DE"
}Endpoint
Quality
OpenAPI schema is present with clear request structure and pricing metadata, but no response schema or example responses are provided. The probe returned 404 because HEAD/GET were used on a POST-only endpoint, so liveness is uncertain but plausible. Crawled pages all returned generic 404 JSON, providing no additional documentation.
Warnings
- —Probe returned 404 on HEAD and GET; endpoint is POST-only so liveness could not be confirmed via the probe
- —No response schema or example response is documented in the OpenAPI spec
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals; if incorrect the price of $0.006 may be wrong
Citations
- —Endpoint accepts POST with a required country_code fieldhttps://abstract-vat.mpp.paywithlocus.com
- —Payment amount is 6000 base units via Tempo methodhttps://abstract-vat.mpp.paywithlocus.com
- —Service described as VAT number validation, rate calculation, and category lookup for EUhttps://abstract-vat.mpp.paywithlocus.com
- —API reference documentation available at AbstractAPIhttps://docs.abstractapi.com/vat
- —Locus-specific docs availablehttps://beta.paywithlocus.com/mpp/abstract-vat.md