Naar de inhoud
API BCEAPI BCEAPI voor Belgische ondernemingsgegevens
ToepassingenPrijzenDocumentatieSandboxAPI-sleutel
🇬🇧 English🇫🇷 Français🇳🇱 Nederlands🇩🇪 Deutsch🇪🇸 Español
API-sleutel
API BCE / Toepassingen / Een klant of leverancier controleren voor je met hem werkt

🛡️ Een klant of leverancier controleren voor je met hem werkt

Voor een eerste bestelbon, een contract of leverancierskrediet één eenvoudige vraag: bestaat deze onderneming nog, en in welke juridische toestand verkeert ze?

Het probleem#

Een aankoopteam neemt een nieuwe leverancier op, een verkoper geeft een nieuwe klant betalingsuitstel. In beide gevallen steunt men vaak op wat de onderneming zelf meedeelt: een naam, een nummer, een adres op een offerte. Niemand controleert of het nummer echt bij die onderneming hoort, of ze nog actief is, of ze geen faillissement of vereffening doormaakt.

De manuele controle bestaat (de openbare zoekfunctie van de KBO), maar schaalt niet: ze moet voor elke derde opnieuw gebeuren, ergens genoteerd worden, en niemand herhaalt ze zes maanden later. Deze controle hoort in je eigen tool, op het moment dat de fiche van de derde wordt aangemaakt.

De API-gegevens die antwoorden#

  • GET /enterprise/{num}: de ondernemingsfiche, met haar status in het register, de code van de juridische toestand, de rechtsvorm, de begindatum en de maatschappelijke zetel.
  • GET /juridical-situations: de referentielijst van de codes van juridische toestand (normale toestand, faillissement, ontbinding…), om te cachen en een code in een label om te zetten.
  • GET /juridical-forms: de referentielijst van rechtsvormen (NV, BV, VZW…) met hun officiële codes.
  • GET /enterprise/{num}/establishments: de gekoppelde vestigingseenheden, nuttig wanneer de derde factureert vanaf een exploitatiezetel.

De fiche bevat een statuscode (AC voor een actieve onderneming) en de code van de juridische toestand. Als die toestand niet normaal is, voegt het antwoord het label en een indicator inDistress toe: dat is het signaal om aan een mens door te geven.

Voorbeeldverzoek#

"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"

Uittreksel van het antwoord, in de standaard JSON-envelope:

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

Aanbevolen aanpak#

  • Doe de call aan de serverkant, bij het aanmaken van de fiche van de derde, nooit vanuit de browser: sleutel en secret mogen je backend niet verlaten.
  • Behandel een 404-antwoord als een signaal, niet als een technische fout: een nummer dat het register niet kent, verdient een menselijke controle.
  • Gebruik drie uitkomsten in plaats van twee: aanvaard, geblokkeerd (onderneming niet actief), na te kijken (abnormale juridische toestand of onbekend nummer).
  • Bewaar de datum van de controle en de ontvangen code in je eigen database: dat bewijst dat de controle plaatsvond.
  • Abonneer derden met wie je langdurig werkt op een webhook in plaats van de controle met de hand te herhalen (zie de toepassing „ondernemingen opvolgen”).

Grenzen om te kennen#

  • De API weerspiegelt wat de KBO heeft gepubliceerd. Een faillissement dat een rechtbank uitspreekt, verschijnt pas zodra het in het register is ingeschreven, niet op de dag van het vonnis.
  • Een actieve status zegt niets over de solvabiliteit of de kwaliteit van een leverancier. Het is een controle van bestaan en juridische toestand, geen kredietscore.
  • De officiële KBO-gegevens vermelden niet altijd waarom een onderneming stopte. Leid geen faillissement af uit een onderneming die enkel inactief is.
  • De financiële samenvatting (/enterprise/{num}/financial) hangt af van de jaarrekeningen die bij de Nationale Bank zijn neergelegd: een kleine onderneming of een natuurlijk persoon heeft er vaak geen.

Veelgestelde vragen#

Hoe weet ik via de API of een Belgische onderneming failliet is?

Roep GET /enterprise/{num} aan. Het antwoord bevat de code van de juridische toestand; als die niet normaal is, voegt het het label en de indicator inDistress toe. De referentielijst GET /juridical-situations vertaalt elke code.

Telt de controle mee in mijn quota?

Ja, elke call naar de ondernemingsfiche telt mee in het maandquota van je sleutel. Alleen het endpoint /me, dat je verbruik toont, wordt niet geteld.

Kan ik een buitenlandse onderneming controleren?

Niet de fiche: de API dekt het Belgische register. Voor een btw-nummer uit een ander land van de Europese Unie gebruik je de VIES-validatie (GET /vat/{vatNumber}).

Aan de slag

Maak een sleutel aan in het ontwikkelaarsportaal en volg daarna de referentiedocumentatie voor elk vermeld endpoint.

API-sleutel aanvragenLees de documentatie

Referentiedocumentatie

  • Onderneming
  • Referentiedata

Andere toepassingen

  • Een CRM automatisch verrijken vanuit het ondernemingsnummer
  • Een btw-nummer valideren (VIES) bij het invoeren van een factuur
  • KYC/KYB bij het openen van een zakelijk account
  • Ondernemingen opvolgen met webhooks

Op deze pagina

Het probleemDe API-gegevens die antwoordenVoorbeeldverzoekAanbevolen aanpakGrenzen om te kennenVeelgestelde vragenAan de slag
API BCEAPI BCE

Een ontwikkelaarsproduct van Espero-Soft Informatiques, gebouwd op officiële KBO/BCE-opendata.

Product

ToepassingenWaarom API BCEPrijzenFAQ

Ontwikkelaars

DocumentatieAPI-referentieAPI-playgroundWijzigingslogboekAPI-sleutel

Bedrijf

Gegevens, compliance en Peppol ↗Company Belgium ↗Espero-Soft ↗

Juridisch

Wettelijke vermeldingenAlgemene gebruiks- en verkoopvoorwaardenPrivacybeleidCookiebeleid
© 2026 Espero-Soft Informatiques SRL · Alle rechten voorbehouden.Gemaakt in België 🇧🇪