Documentation > Geolocation

API - Check VAT numbers (vat_check)

Geolocation

Tells you whether VAT numbers are valid and, when they are, the name and address of the company they belong to. Up to 25 in one call.

Endpointhttps://api.opensolr.com/solr_manager/api/vat_check
MethodGET or POST
Authemail and api_key of your account, as GET or POST parameters: Authentication.

01 · Parameters

vat_numberOne of the two

One number with its country prefix, such as RO12345678. Spaces, dots, dashes and slashes are ignored. Greece is EL.

vat_numbersOne of the two

Up to 25: an array, a JSON array, or separated by ; or new lines.

02 · Example

curl -s "https://api.opensolr.com/solr_manager/api/vat_check?email=YOUR_EMAIL&api_key=YOUR_API_KEY&vat_number=DE123456789"

03 · Answer

{
    "status": true,
    "contract_version": 1,
    "count": 1,
    "results": {
        "DE123456789": {
            "valid": false,
            "country_code": "DE",
            "vat_number": "123456789"
        }
    }
}

valid is true or false when the registry answered. A valid number also carries name, address and request_date when the registry gives them.

valid is null, with msg, when there is no answer: ERROR_INVALID_VAT_NUMBER_FORMAT, ERROR_UNSUPPORTED_VAT_COUNTRY or ERROR_VAT_LOOKUP_UNAVAILABLE (retry later).

Values shown are an example.

04 · Errors

ERROR_NO_VAT_NUMBER_SUPPLIEDHTTP 200

No number. The answer carries max_vat_numbers.

WRONG_API_HOSTHTTP 404

Called on opensolr.com. The answer carries the right URL.

ERROR_AUTHENTICATION_FAILEDHTTP 403

The email and API key do not match.

ERROR_RATE_LIMIT_PER_MINUTEHTTP 429

Too many calls. Wait for the Retry-After seconds.

Each call counts once toward your per-minute and per-hour limits, whatever the number of items: Rate limits. Lookups never use the AI allowance.

05 · Related

VAT rates: vat_rates.

Every error code and HTTP status of the API: API errors. Calls per minute and per hour: Rate limits.