Belgian Crossroads Bank for Enterprises (KBO) API: volledige Engelstalige developer-documentatie
Engelstalige developer-documentatie voor de API van de Belgische Kruispuntbank van Ondernemingen. Overzicht van het KBO/BCE-register, wettelijke context, toegangsopties, snelle start met cURL-voorbeelden en integratiepatronen voor internationale developers.
In het kort
De Belgian Crossroads Bank for Enterprises (KBO/BCE) API biedt toegang tot de officiele gegevens van alle Belgische ondernemingen. Voor internationale developers biedt Company Belgium de snelste weg: REST/JSON, gratis plan zonder bankkaart, cURL-voorbeelden en Python- en TypeScript-SDK's beschikbaar.
> Dit artikel is gericht op internationale developers die de Belgische KBO integreren. Voor het leesgemak staat de volledige inhoud in het Engels in de "en"-versie. Deze NL-versie is een samenvatting.
Samenvatting in het Nederlands
De Belgian Crossroads Bank for Enterprises API (in het Nederlands: Kruispuntbank van Ondernemingen — afgekort KBO; in het Frans: BCE) geeft toegang tot de officiële gegevens van alle in België geregistreerde ondernemingen.
Voor niet-Belgische developers die deze gegevens moeten integreren:
- Wettelijke bron: FOD Economie (Belgische overheid)
- Volume: ~2 miljoen actieve ondernemingen, ~1,7 miljoen vestigingen
- Toegang: officiële SOAP (kbopub.economie.fgov.be), Open Data via FTP, of REST-API's van derden
Om snel te starten: zie de Python-tutorial, de Node.js-tutorial, de API-vergelijking en de volledige KBO endpoints-referentie.
De volledige Engelstalige versie hieronder behandelt de technische details.
Veelgestelde vragen
Wat is de Belgian Crossroads Bank for Enterprises (KBO/BCE) ?
De Belgian Crossroads Bank for Enterprises (afgekort KBO in het Nederlands en BCE in het Frans) is het officiele centrale Belgische register van alle rechtspersonen: ondernemingen, zelfstandigen, vzw's, stichtingen en openbare instellingen. Het wordt beheerd door FOD Economie en bevat circa 2 miljoen actieve entiteiten die dagelijks worden bijgewerkt.
Hoe kan een internationale developer toegang krijgen tot Belgische KBO-gegevens ?
Een internationale developer heeft drie toegangskanalen: de gratis officiele SOAP-API (kbopub.economie.fgov.be), de FTP-download van Open Data-bestanden (full en dagelijkse delta), of een REST-API van derden zoals Company Belgium die een gratis plan zonder bankkaart aanbiedt, Engelstalige documentatie en Python- en TypeScript-SDK's.
Welke identificatoren worden gebruikt in de Belgische KBO-database ?
De KBO gebruikt twee hoofdidentificatoren. Het ondernemingsnummer is een 10-cijferige code in het formaat NNNN.NNN.NNN die rechtspersonen identificeert; het Belgische btw-nummer is het ondernemingsnummer met voorvoegsel BE. Het vestigingsnummer, ook 10 cijfers beginnend met 2, identificeert de fysieke locaties (filialen, kantoren) van een entiteit.
Is GDPR-conformiteit vereist bij het gebruik van de KBO API ?
Gegevens over rechtspersonen (ondernemingen) zijn geen persoonsgegevens in de zin van de GDPR. Maar informatie over zelfstandige natuurlijke personen, bestuurdersgegevens en UBO-begunstigden zijn persoonsgegevens die onderworpen zijn aan de GDPR en de strikte toegangsregels uit het HvJ-arrest van 22 november 2022.
Reacties
Gerelateerde artikelen
Rate limits, quota en caching om een KBO/BCE-applicatie te schalen: referentie-architectuur
Uw app bevraagt de KBO/BCE-API in volume — hoe 429's vermijden, kosten beheersen en latency garanderen? Referentie-architectuur met meerlaags cache, requestwachtrij, observability en webhooks. Concrete patronen en streefcijfers.
BCE/KBO API endpoints reference: volledige lijst van REST-routes (companies, addresses, NACE, UBO, vestigingen, Peppol)
Technische referentie van de REST-endpoints van de Company Belgium-API: zoeken, bedrijfsfiche, adressen, NACE-activiteiten, vestigingen, bestuurders, UBO, Peppol-verificatie. Met responsschema's, parameters en foutcodes.
Officiële KBO-API vs API's van derden: beperkingen van de openbare BCE-dienst en waarom overstappen op een moderne API
De officiële FOD Economie-API is gratis — maar ze is SOAP, zonder webhooks, zonder UBO- of Peppol-verrijking en zonder SLA. Hier in detail waarom 80% van de ernstige projecten uiteindelijk migreert naar een API van derden, en hoe te evalueren of dat ook voor u geldt.