Skip to main content

Global Company Tax Number Verification

Verify company tax numbers (VAT/EIN) across multiple countries. Supports EU VAT verification and country-specific tax number validation.

Endpoints:

  • POST /biz/bigdata/tax-number/verify
  • POST /biz/bigdata/eu/vat/verify

Both endpoints are functionally identical.

Parameters​

ParameterTypeRequiredDescription
countryCodeStringYesISO 3166-1 alpha-2 country code
taxNumberStringYesTax number to verify

Request​

curl -X POST "https://api.alaikis.com/std/biz/bigdata/tax-number/verify" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret" \
  -d 'bizContent={"countryCode": "DE", "taxNumber": "DE123456789"}'

Response​

{
  "code": 200,
  "msg": "success",
  "data": {
    "valid": true,
    "countryCode": "DE",
    "taxNumber": "DE123456789",
    "name": "Company Name GmbH",
    "address": "Berlin, Germany"
  }
}

Supported Countries​

EU VAT Verification​

All EU member states are supported through the VIES (VAT Information Exchange System):

CountryCodeFormat Example
AustriaATATU12345678
BelgiumBEBE0123456789
BulgariaBGBG123456789
CroatiaHRHR12345678901
CyprusCYCY12345678X
Czech RepublicCZCZ12345678
DenmarkDKDK12345678
EstoniaEEEE123456789
FinlandFIFI12345678
FranceFRFR12345678901
GermanyDEDE123456789
GreeceELEL123456789
HungaryHUHU12345678
IrelandIEIE1234567X
ItalyITIT12345678901
LatviaLVLV12345678901
LithuaniaLTLT123456789
LuxembourgLULU12345678
MaltaMTMT12345678
NetherlandsNLNL123456789B01
PolandPLPL1234567890
PortugalPTPT123456789
RomaniaRORO1234567890
SlovakiaSKSK1234567890
SloveniaSISI12345678
SpainESESA1234567X
SwedenSESE123456789001

Country-Specific Verification​

Some countries have dedicated verification logic beyond EU VIES. The system automatically routes to the appropriate verification method based on the countryCode.

Error Codes​

CodeDescription
400Invalid JSON format
406Missing required parameters (countryCode and taxNumber)
500Verification service error