Belgian Company Lookup → JSON

One number in, one structured JSON record out: identifiers, VIES name and address, VAT status and Peppol capabilities.

Local: no. The enterprise number is sent to VIES (European Commission) and the Peppol network to retrieve the company and Peppol status.

🌐 External lookup: this page sends the number to our server, which asks the EU VIES service and the Peppol SML/SMP and Directory. Results are cached for a few hours.

How the lookup works

Type or paste one Belgian enterprise number or VAT number in any common form: 0417.497.106, BE0417497106 or the old 9-digit 417497106. The number is first validated in your browser with the modulo-97 rule, so a typo is caught before anything goes online. Only a valid number is sent to our server, which asks two public registers at the same time:

  • VIES, the European Commission's VAT validation service, which queries the Belgian VAT administration and returns whether the VAT number is active, plus the registered name and address.
  • The Peppol network: an SML lookup tells whether the company is registered as 0208: + enterprise number, and the SMP of its access point lists which document types (invoice, credit note, order...) it can receive.

Everything else in the record (the formatted enterprise number, VAT number and both Peppol IDs) is computed locally from the digits.

Sample output

Input 417497106 gives a record shaped like this (name and address shortened):

{
  "enterpriseNumber": "0417.497.106",
  "enterpriseNumberDigits": "0417497106",
  "vatNumber": "BE0417497106",
  "peppolIds": {
    "primary": "iso6523-actorid-upis::0208:0417497106",
    "vat": "iso6523-actorid-upis::9925:BE0417497106"
  },
  "vies": { "valid": true, "name": "...", "address": "...", "checkedAt": "..." },
  "peppol": { "registered": true, "smp": "...", "documentTypes": [ ... ] }
}

Copy it or download it as company-0417497106.json to feed a spreadsheet, a CRM import or a supplier-onboarding checklist.

Edge cases worth knowing

  • Valid but not active for VAT. Many non-profits, some VAT-exempt businesses and stopped companies have an enterprise number but no active VAT number. VIES then answers "not valid" even though the number is correct.
  • Not on Peppol under 0208. Some companies registered only under the VAT-based scheme 9925. Check both IDs with the Peppol ID checker before concluding they cannot receive e-invoices.
  • Establishment units (numbers starting with 2 to 8) are not companies and are not in VIES.
  • VIES downtime. The Belgian VIES node is sometimes unavailable for minutes; the record then carries an error instead of a name, and you can retry.

Legal form, NACE activities, directors and establishment units live in the KBO/BCE, which has no free real-time API. Decode the codes from the monthly KBO Open Data files with the KBO code lookup and NACE-BEL lookup, and read the guide to Belgian company identifiers for how the numbers relate.

Frequently asked questions

Can I find a Belgian company by name here?

No. The lookup starts from an enterprise or VAT number, because VIES and Peppol are queried by number. To search by name, use the public KBO search of FPS Economy, then paste the number you find.

Why does VIES say the number is not valid when the company exists?

VIES only confirms active VAT registrations. A company that is not registered for VAT, not yet registered or stopped still has a valid enterprise number but shows as not active in VIES.

What does the Peppol part of the record mean?

It shows whether the company is registered on the Peppol network under 0208 plus its enterprise number, which access point metadata server (SMP) serves it and which document types it can receive.

Is the lookup stored or logged with my number?

The number is validated in your browser and only sent to our server to query VIES and Peppol at the moment you look it up. The result is not stored on gratistools.be.

Can I look up many companies at once?

This tool handles one number at a time. For lists, clean and validate the numbers first with the VAT number checker or the enterprise number batch cleaner, which also produce the Peppol IDs.