Skip to main content

​
Description

The VatAPI.validate() method is used to communicate with this endpoint as seen below: VatAPI.validate(vat_number)

​
Query Parameters

​
vat_number
String
required
The VAT number you want to validate

​
Usage

Below is a code snippet to query the VatAPI.validate() method: 
from abstract_python import VatAPI

api_key = "your-vat-api-key"

api = VatAPI(api_key)
vat_number = "SE556656688001"
response = api.validate(vat_number)

print(response)
Below is the response object: 
{
    "vat_number": "SE556656688001",
    "valid": true,
    "company": {
        "name": "GOOGLE SWEDEN AB",
        "address": "GOOGLE IRLAND LTD \nM COLLINS, GORDON HOUSE \nBARROW STREET, DUBLIN 4 \nIRLAND"
    },
    "country": {
        "code": "SE",
        "name": "Sweden"
    }
}

​
Response Fields

​
vat_number
String
The VAT number to validate
​
is_vat_valid
Boolean
A boolean value to check if the VAT number is valid. True if VAT number is valid.
​
company_name
String
The company associated with the VAT number
​
company_address
String
The company’s address.
​
company_country
String
The country where the company is located
​
company_country_code
String
The two letter ISO 3166-1 alpha-2 code of the country associated with the VAT number.

​
Error response

If you entered an invalid VAT number in the query, you will get an error message as seen below: 
{
    'error': {
        'message': 'A validation error occurred.', 
        'code': 'validation_error', 
        'details': {
            'vat_number': ['Invalid VAT number']
        }
    }, 
    'status': 400
}