VIES (Vat Validation)

The VAT Information Exchange System (VIES) is a tool developed by the European Commission to facilitate the validation of VAT (Value Added Tax) identification numbers issued by EU Member States

What kind of data I will get

The VIES VAT Number Validation API offers a straightforward yet essential set of data aimed at confirming the validity of VAT numbers within the European Union

Input

Attribute	Type	Description
vatNumber	String	Vat number to validate
countryCode	String	Country code of validated entity in ISO 3166 format e.g.: PL, DE

Input Example

{
    "vatNumber": "123456",
    "countryCode": "PL"
}

Output

Vat Validation

Attribute	Type	Description
isValid	Boolean	Indicates if the VAT number is valid.
userError	String	Error message in case of incorrect VAT number.
name	String	Name of the company.
address	String	Address of the company.
requestIdentifier	String	Unique identifier for the request.
originalVatNumber	String	Original VAT number provided in the request.
vatNumber	String	Processed VAT number.
requestDate	String	Date of the request.
viesApproximate	Object	Nested object containing approximate VAT details.

Vies Approximate

Attribute	Type	Description
name	String	Approximate name of the company.
street	String	Approximate street of the company.
postalCode	String	Approximate postal code of the company.
city	String	Approximate city of the company.
companyType	String	Approximate type of the company.
matchName	String	Matched name of the company.
matchStreet	String	Matched street of the company.
matchPostalCode	String	Matched postal code of the company.
matchCity	String	Matched city of the company.
matchCompanyType	String	Matched type of the company.

Output Example

{
  "isValid": true,
  "userError": null,
  "name": "John Doe",
  "address": "123 Main St, Anytown, Country",
  "requestIdentifier": "REQ123456789",
  "originalVatNumber": "ABC123456",
  "vatNumber": "XYZ987654",
  "requestDate": "2023-10-01T12:34:56Z",
  "viesApproximate": {
    "name": "John's Company",
    "street": "456 Elm St",
    "postalCode": "12345",
    "city": "Big City",
    "companyType": "LLC",
    "matchName": "John's Company LTD",
    "matchStreet": "789 Pine St",
    "matchPostalCode": "67890",
    "matchCity": "Another City",
    "matchCompanyType": "Corporation"
  }
}