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

Parameter	Type	Required	Description
countryCode	String	Yes	ISO 3166-1 alpha-2 country code
taxNumber	String	Yes	Tax 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):

Country	Code	Format Example
Austria	AT	ATU12345678
Belgium	BE	BE0123456789
Bulgaria	BG	BG123456789
Croatia	HR	HR12345678901
Cyprus	CY	CY12345678X
Czech Republic	CZ	CZ12345678
Denmark	DK	DK12345678
Estonia	EE	EE123456789
Finland	FI	FI12345678
France	FR	FR12345678901
Germany	DE	DE123456789
Greece	EL	EL123456789
Hungary	HU	HU12345678
Ireland	IE	IE1234567X
Italy	IT	IT12345678901
Latvia	LV	LV12345678901
Lithuania	LT	LT123456789
Luxembourg	LU	LU12345678
Malta	MT	MT12345678
Netherlands	NL	NL123456789B01
Poland	PL	PL1234567890
Portugal	PT	PT123456789
Romania	RO	RO1234567890
Slovakia	SK	SK1234567890
Slovenia	SI	SI12345678
Spain	ES	ESA1234567X
Sweden	SE	SE123456789001

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

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