Validate VAT numbers.

This endpoint allows you to validate a company’s VAT number. It returns the company’s data if the VAT number is valid

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
}