country_unsupported
The VAT number's country prefix maps to a country that vatverify does not support.
HTTP 400 · Bad Request
Example response
{
"error": {
"code": "country_unsupported",
"message": "Country AU is not supported."
},
"meta": {
"request_id": "a1b2c3d4-...",
"latency_ms": 0
}
}What happened
The two-letter country prefix on the VAT number (e.g. AU123456789) maps to a country outside our 32 supported. vatverify covers EU-27, UK, Switzerland, Liechtenstein, and Norway. Other countries return this error.
How to fix
- Check the Supported Countries page for the full list of valid country codes.
- If you are validating a Greek VAT number, use
ELnotGR. Greece is the one EU member state that uses a non-ISO code in VIES. - For unsupported countries, apply offline format validation using
@vatverify/vat-rateswhich covers 44 countries with checksum algorithms.
Common mistakes
- Using
GRfor Greece: the correct VIES code isEL. This is the most common cause of unexpectedcountry_unsupportederrors from EU developers. - Sending Australian ABN numbers: AU is not yet supported for live validation.
- Passing a raw number without a country prefix: the API requires the full VAT number including the country code prefix (e.g.
DE811569869, not811569869).
Related errors
country_unknown: country code not in the rates dataset (rates endpoints only)invalid_format: the VAT number string itself is malformed