- checkVatService: validity, name and address for any EU VAT number, same data as the REST API
- Qualified checks with your requester VAT number return the consultation number for audit evidence
- checkStatusService: availability of each member state's database
- Test service endpoint with reserved numbers for integration tests
- SOAP envelopes built and parsed by Apivom Atlas — your systems send and receive plain JSON
EU VAT Validation API (VIES SOAP)
The European Commission's original VIES SOAP web services — checkVat, checkVatApprox-style qualified checks and checkStatus — wrapped as JSON routes on the Apivom Atlas gateway for systems that must stay on the SOAP contract.
What you can do
Use cases
- Legacy ERP compatibility — Keep tax engines and ERP connectors that were certified against the VIES SOAP contract working, while moving transport, retries and logging to Apivom Atlas.
- Fallback validation — Use the SOAP route as a secondary path when the REST endpoint is degraded; both reach the same national registers.
Before the REST API existed, VIES was only available as SOAP web services, and many ERP and tax engines still integrate the SOAP contract. Apivom Atlas registers the three SOAP services — checkVatService, checkVatTestService and checkStatusService — as gateway routes that accept and return JSON while Atlas builds the SOAP envelope, calls ec.europa.eu and parses the response. The result is identical to the REST route: validity, trader name and address where the member state publishes them, the request date and, for qualified checks, the consultation number. Choose this variant when a downstream system or an existing certification depends on the SOAP response fields; otherwise use the VIES REST integration.
Available to provisioned Apivom tenants through the Atlas gateway (used by Apivom Iris); not yet self-serve in the Atlas portal. Contact us to enable it for your tenant.
Frequently asked questions
Should I use the SOAP or the REST VIES integration?
Use REST unless an existing system depends on the SOAP response structure. Both return the same validity, name, address and consultation data from the same member-state databases.
Do I need to build SOAP envelopes myself?
No. Apivom Atlas accepts a JSON body with the country code, VAT number and optional requester fields, constructs the SOAP request and returns the parsed JSON response.
Can I buy this API self-serve in the Atlas portal?
Not yet. This source runs on the Atlas gateway for provisioned tenants and inside Apivom Iris; per-query portal pricing has not been published. Request access and we enable it for your tenant with logging and quota visibility.
More Atlas integrations
AI integration guide (llms.txt)
Machine-readable markdown — feed it to your AI assistant as integration instructions.