Skip to main content
GET
/
v1
/
validate
Validate VAT endpoint
curl --request GET \
  --url https://vat.cleariflow.com/v1/validate/
{
    "company": {
        "address": "8 RUE DE LONDRES\n75009 PARIS",
        "name": "EURL GOOGLE FRANCE"
    },
    "country": {
        "code": "FR",
        "name": "France"
    },
    "valid": true,
    "vat_number": "FR64443061841"
}

​
Getting started

​
Base URL

https://vat.cleariflow.com/v1/validate/

​
Validation endpoint

The validate endpoint requires your unique API key and the VAT number you’d like to check: 
https://vat.cleariflow.com/v1/validate/
? api_key = YOUR_UNIQUE_API_KEY
& vat_number = FR64443061841
This successful request returns comprehensive company information associated with the validated VAT number: 
{
    "company": {
        "address": "8 RUE DE LONDRES\n75009 PARIS",
        "name": "EURL GOOGLE FRANCE"
    },
    "country": {
        "code": "FR",
        "name": "France"
    },
    "valid": true,
    "vat_number": "FR64443061841"
}

​
Request parameters

​
api_key
String
required
Your unique API key. Note that each user has unique API keys for each of Cleariflow APIs, so your VAT Validation and Rates API key will not work for your IP Geolocation API, for example.
​
vat_number
String
required
The VAT number to validate.

​
Response parameters

The API response is returned in a universal and lightweight JSON format.
​
vat_number
String
The VAT number to validate.
​
valid
Boolean
Is true if the submitted VAT number is valid.
​
company
Object
Object containing company information.
​
company.name
String
The name of the company associated with the VAT number.
​
company.address
String
The address of the company associated with the VAT number.
​
country
Object
Object containing country information.
​
country.code
String
The two letter ISO 3166-1 alpha-2 code of the country associated with the VAT number.
​
country.name
String
The name of the country associated with the VAT number.