VAT ID Check
Validate EU VAT IDs. Supports simple format validation and qualified checks with company data cross-verification.
Method: vatIdCheck
API KeyNot set
Stored in localStorage — never sent to this site.
Parameters
Required for qualified check
Request Preview
{
"jsonrpc": "2.0",
"id": 1,
"method": "vatIdCheck",
"params": {}
}Set an API key above to enable live requests.
Two Modes
Simple Mode
Validates format and existence only.
json
{
"jsonrpc": "2.0",
"id": 1,
"method": "vatIdCheck",
"params": {
"vatId": "DE297464149"
}
}Qualified Mode
Validates VAT ID and cross-checks company name and address against the EU VIES system / BZST. Returns a certification certificate.
Approval required
Qualified checks require implementation approval from Endereco. Contact support@endereco.de.
Parameters
| Field | Required | Type | Description |
|---|---|---|---|
vatId | Yes | String | VAT ID to check |
requesterVatID | Qualified | String | Your own VAT ID |
companyName | Qualified | String | Company name to verify |
companyPostalCode | Qualified | String | Postal code |
companyLocality | Qualified | String | City |
companyStreetFull | Qualified* | String | Street + house number combined |
companyStreet | Qualified* | String | Street name only |
companyHouseNumber | Qualified* | String | House number only |
timeout | No | Int | Timeout 5–60s (default 60) |
allowCache | No | Boolean | Allow cached responses (default true) |
*Either companyStreetFull or (companyStreet + companyHouseNumber)
Response (Qualified)
json
{
"result": {
"predictions": [
{
"vatId": "DE297464149",
"companyName": "endereco UG (haftungsbeschränkt) ...",
"companyAddress": "Balthasar-Neumann Str. 4 b, 97236, Randersacker",
"companyAddressFormatted": {
"streetFull": "Balthasar-Neumann Str. 4 b",
"postCode": "97236",
"cityName": "Randersacker",
"country": "DE"
}
}
],
"certification": {
"ErrorCode": "200",
"Date": "18.05.2026",
"Time": "11:31:57",
"Type": "BZST"
},
"status": [
"vat_id_valid",
"vat_id_format_correct",
"vat_id_company_address_match"
]
}
}Status Codes
| Code | Meaning |
|---|---|
vat_id_valid | VAT ID is valid |
vat_id_invalid | VAT ID is invalid |
vat_id_unknown_status | Cannot determine validity |
vat_id_format_correct | Format is valid for country |
vat_id_format_invalid | Format error |
vat_id_company_name_match | Company name matches |
vat_id_company_name_mismatch | Company name does not match |
vat_id_company_address_match | Address matches |
vat_id_company_address_mismatch | Address does not match |
vat_id_company_postal_code_match | Postal code matches |
vat_id_company_locality_match | City matches |
BZST Certification Codes
| Code | Meaning |
|---|---|
200 | Valid |
201 | Invalid |
205 | Query temporarily unavailable |
206 | Requester's German VAT ID is invalid |
213 | Not authorized to query German VAT ID |
Qualified Check Example
json
{
"jsonrpc": "2.0",
"id": 1,
"method": "vatIdCheck",
"params": {
"vatId": "DE297464149",
"requesterVatID": "DE297464149",
"companyName": "endereco",
"companyPostalCode": "97236",
"companyLocality": "Randersacker",
"companyStreetFull": "Balthasar-Neumann Str. 4b"
}
}