API Depot/APIs/VAT Validation

VAT Validation

live

Validate EU and UK VAT numbers against the official VIES service. Returns the company name, address, and country code when the number is active.

POST /v1/vat/validatePer request

Request

FieldTypeDescription
vat_number*stringVAT number with 2-letter country prefix (e.g. PT123456789, GB123456789)

Response

FieldTypeDescription
validbooleanWhether the VAT number is active and registered
vat_numberstringThe original VAT number as submitted
country_codestring2-letter ISO country code
company_namestringRegistered company name (empty string if not available)
addressstringRegistered address (empty string if not available)

Example

Request

{
  "vat_number": "PT545259045"
}

Response

{
  "valid": true,
  "vat_number": "PT545259045",
  "country_code": "PT",
  "company_name": "ACME PORTUGAL LDA",
  "address": "R. EXEMPLO 123, 1000-001 LISBOA"
}

Notes

  • –Sync endpoint — typically responds in under 500ms
  • –Powered by the EU VIES SOAP service. May return 503 when VIES is temporarily unavailable.
  • –A valid: false response is a legitimate result (inactive/unregistered number), not an error.
  • –UK VAT numbers are supported with the GB prefix.

Try it