Skip to content

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

FieldRequiredTypeDescription
vatIdYesStringVAT ID to check
requesterVatIDQualifiedStringYour own VAT ID
companyNameQualifiedStringCompany name to verify
companyPostalCodeQualifiedStringPostal code
companyLocalityQualifiedStringCity
companyStreetFullQualified*StringStreet + house number combined
companyStreetQualified*StringStreet name only
companyHouseNumberQualified*StringHouse number only
timeoutNoIntTimeout 5–60s (default 60)
allowCacheNoBooleanAllow 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

CodeMeaning
vat_id_validVAT ID is valid
vat_id_invalidVAT ID is invalid
vat_id_unknown_statusCannot determine validity
vat_id_format_correctFormat is valid for country
vat_id_format_invalidFormat error
vat_id_company_name_matchCompany name matches
vat_id_company_name_mismatchCompany name does not match
vat_id_company_address_matchAddress matches
vat_id_company_address_mismatchAddress does not match
vat_id_company_postal_code_matchPostal code matches
vat_id_company_locality_matchCity matches

BZST Certification Codes

CodeMeaning
200Valid
201Invalid
205Query temporarily unavailable
206Requester's German VAT ID is invalid
213Not 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"
  }
}

Endereco JSON-RPC API