Loading
Loading
Validate any EU or UK VAT registration number in real time against the issuing authority. Returns the registered business name, address, and validity status directly from VIES (EU) or HMRC (UK).
Routing to the correct authority is automatic based on the VAT number prefix. Pass your own VAT number as requesterVatNumber to receive a timestamped consultation reference for audit purposes.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The vatNumber parameter is required and must include the country prefix (e.g., GB150848114, DE811101930).
vatNumberrequiredstringVAT number to validate including country prefix (e.g., DE123456789, GB150848114).
requesterVatNumberoptionalstringYour own VAT number. When provided, returns a VIES/HMRC consultation number for audit purposes.
A successful request returns a 200 OK with a JSON object containing validation status, company details, and authority information.
country_codeVAT country prefix extracted from the validated VAT number (e.g., DE, GB).
vat_numberVAT number without country prefix.
requester_country_codeRequester VAT country prefix (present only when requesterVatNumber was provided).
requester_vat_numberRequester VAT number without country prefix.
requested_atISO 8601 timestamp of the validation request.
validationValidation result block.
validation.is_validWhether the VAT number is active and registered.
validation.consultation_numberVIES/HMRC consultation number. Only present when requesterVatNumber is provided.
validation.consultation_authorityUpstream authority used for validation (VIES for EU, HMRC for UK).
companyCompany details block.
company.company_nameCompany or trader name (may be empty string when unavailable).
company.company_addressFormatted company address (may be empty string when unavailable).
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
please pass correct parameters
Unsupported VAT country code. Supported prefixes are UK/GB and EU VAT country codes.
targetVrn does not match a registered company