Skip to content
API BCEAPI BCEBelgian company data API
Use casesPricingDocumentationSandboxGet API key
🇬🇧 English🇫🇷 Français🇳🇱 Nederlands🇩🇪 Deutsch🇪🇸 Español
Get API key
API BCE / Use cases / Check a client or supplier before working with them

🛡️ Check a client or supplier before working with them

Before a first purchase order, a contract or supplier credit, one simple question: does this company still exist, and what is its legal situation?

The problem#

A purchasing team adds a new supplier, a sales rep grants payment terms to a new client. In both cases the team often relies on what the company says about itself: a name, a number, an address on a quote. Nobody checks that the number really belongs to that company, that it is still active, or that it is not going through bankruptcy or liquidation.

The manual check exists (the public BCE search), but it does not scale: it has to be repeated for every third party, written down somewhere, and nobody runs it again six months later. This check belongs in your own tool, at the moment the third party record is created.

The API data that answers it#

  • GET /enterprise/{num}: the company record, with its status in the register, its legal situation code, its legal form, its start date and its registered office.
  • GET /juridical-situations: the reference list of legal situation codes (normal situation, bankruptcy, dissolution…), to cache and use to turn a code into a label.
  • GET /juridical-forms: the reference list of legal forms (SA, SRL, ASBL…) with their official codes.
  • GET /enterprise/{num}/establishments: the attached establishment units, useful when the third party invoices you from an operating site.

The record carries a status code (AC for an active company) and the legal situation code. When that situation is not normal, the response adds its label and an inDistress flag: that is the signal to send to a human.

Example request#

"tok-comment"># Enterprise record: status, juridical situation, legal form
curl https://companybelgium.be/api/v2/enterprise/1033.022.383 \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
"tok-comment">
# Reference list of juridical situation codes (cache it on your side)
curl "https://companybelgium.be/api/v2/juridical-situations" \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"

Excerpt of the response, inside the standard JSON envelope:

{
  "success": true,
  "data": {
    "enterpriseNumber": "1033.022.383",
    "name": "ESPERO-SOFT INFORMATIQUES",
    "statusCode": "AC",
    "juridicalSituationCode": "...",
    "inDistress": "...",
    "juridicalFormCode": "610"
  },
  "timestamp": "...",
  "meta": {
    "responseTime": "..."
  }
}

Recommended implementation#

  • Make the call server side, when the third party record is created, never from the browser: the key and secret must not leave your backend.
  • Treat a 404 response as a signal, not as a technical error: a number unknown to the register deserves a human check.
  • Use three outcomes rather than two: accepted, blocked (company not active), to review (abnormal legal situation or number not found).
  • Store the date of the check and the code received in your own database: it proves the check took place.
  • For third parties you work with over time, subscribe them to a webhook instead of repeating the check by hand (see the “monitor companies” case).

Limits to know#

  • The API reflects what the BCE has published. A bankruptcy declared by a court only appears once it is recorded in the register, not on the day of the judgment.
  • An active status says nothing about the solvency or the quality of a supplier. It is a check of existence and legal situation, not a credit rating.
  • The official BCE data does not always state why a company stopped. Do not infer a bankruptcy from a company that is merely inactive.
  • The financial summary (/enterprise/{num}/financial) depends on accounts filed with the National Bank: a small company or a sole trader often has none.

Frequently asked questions#

How can I tell through the API whether a Belgian company is bankrupt?

Call GET /enterprise/{num}. The response contains the legal situation code; when it is not normal, it adds its label and the inDistress flag. The GET /juridical-situations reference list translates each code.

Does the check count against my quota?

Yes, each call to the company record counts against the monthly quota of your key. Only the /me endpoint, which shows your usage, is not counted.

Can I check a foreign company?

Not the record: the API covers the Belgian register. For a VAT number from another European Union country, use the VIES validation (GET /vat/{vatNumber}).

Put it into practice

Create a key in the developer portal, then follow the reference documentation for each endpoint mentioned.

Get an API keyRead the documentation

Reference documentation

  • Enterprise
  • Reference data

Other use cases

  • Enrich a CRM automatically from the company number
  • Validate a VAT number (VIES) when entering an invoice
  • KYC/KYB when opening a business account
  • Monitor companies with webhooks

On this page

The problemThe API data that answers itExample requestRecommended implementationLimits to knowFrequently asked questionsPut it into practice
API BCEAPI BCE

A developer product by Espero-Soft Informatiques, built on official BCE/KBO open data.

Product

Use casesWhy API BCEPricingFAQ

Developers

DocumentationAPI ReferenceAPI PlaygroundChangelogGet API key

Company

Data, compliance and Peppol ↗Company Belgium ↗Espero-Soft ↗

Legal

Legal noticeTerms of ServicePrivacy PolicyCookie Policy
© 2026 Espero-Soft Informatiques SRL · All rights reserved.Made in Belgium 🇧🇪