Wat is het verschil tussen de officiele KBO-API en een API van derden zoals Company Belgium ?

De officiele API van FOD Economie (KBOPublicSearch) is gratis maar werkt met SOAP/XML, zonder OpenAPI-documentatie, webhooks of SLA. Een API van derden zoals Company Belgium biedt dezelfde KBO-gegevens in REST/JSON met webhooks, UBO-cascade, Peppol-verificatie en developer support, wat de integratietijd terugbrengt van 3-5 dagen naar minder dan een dag.

Kan de officiele KBO-API worden gebruikt voor een productieproject ?

Ja, dat is mogelijk voor eenvoudig gebruik zoals incidentele btw-nummervericatie of wekelijkse bulkverwerking. Maar voor een project met een client-SLA, KYC/AML of realtime wijzigingsopvolging overschrijden de verborgen kosten van de SOAP-API (ontwikkeling, polling, handmatige UBO-kruisingen) snel het tarief van een API van derden.

Wat is KBOPublicSearch en hoe krijgt u er toegang toe ?

KBOPublicSearch is de officiele SOAP-dienst van FOD Economie op kbopub.economie.fgov.be. Het is gratis en vereist geen API-sleutel, maar retourneert XML. De toegang vereist het genereren van een SOAP-client (wsdl2java, suds, enz.) en het verwerken van XML-envelopes met namespaces, wat meerdere ontwikkelingsdagen kost op een moderne stack.

Is KBO Open Data anders dan KBOPublicSearch ?

Ja. KBO Open Data is een FTP-download van gecomprimeerde CSV-bestanden (full + dagelijkse delta, circa 500 MB), terwijl KBOPublicSearch een SOAP-dienst is voor realtime bevragingen. Open Data is ideaal voor het vullen van een data warehouse of bulkverwerking, maar ongeschikt voor puntcontroles of online applicaties.

Officiele KBO-API vs API's van derden: 6 beperkingen

In het kort

De officiele SOAP-API van FOD Economie is gratis en betrouwbaar, maar legt in 2026 hoge technische kosten op: geen REST/JSON, geen webhooks, geen UBO, geen Peppol, geen SLA. Voor productieprojecten met een client-SLA of KYC/AML-vereisten is migreren naar een moderne API van derden economisch voordeliger zodra de verborgen kosten worden meegeteld.

Wat niemand u over de officiële API vertelt

Eerst dit: de officiële API van de FOD Economie is een gratis openbare dienst en kostbaar. Zonder haar zou het hele ecosysteem van Belgische bedrijfsgegevens niet bestaan. Al de rest, inclusief Company Belgium, hangt ervan af.

Maar in 2026 een serieus project rechtstreeks tegen de officiële API starten, betekent zichzelf een onnodige technische en functionele last opleggen. Hier precies waarom.

Wat de officiële API biedt

De FOD Economie biedt drie kanalen:

KBOPublicSearch — een SOAP-dienst voor bedrijfsopzoeking en raadpleging

EnterpriseRegister — een geauthentiseerde SOAP-dienst voor erkende actoren (notarissen, griffies, banken)

KBO Open Data — een dagelijkse FTP-download van CSV ZIP-bestanden (full + delta)

Alles is gratis en dagelijks gevoed. Officiële bron, betrouwbare gegevens.

De 6 concrete beperkingen

1. SOAP in 2026

KBOPublicSearch is SOAP/XML. Uw moderne stack (Node.js, Python, Go, Ruby) moet:

Een SOAP-client genereren (wsdl2java, suds-jurko, gsoap, enz.)

XML-envelopes met namespaces parsen

SOAP-foutcodes afhandelen, geen HTTP

Verzoeken handmatig serialiseren

Kost: +3 tot 5 dagen op de initiële integratie, en een permanent cluster van bugs bij schema-updates.

2. Geen webhooks

Wilt u reageren op wijzigingen (een cliënt wordt inactief, een nieuwe bestuurder benoemd, een rekening neergelegd), dan moet u pollen. Voor 10 000 opgevolgde cliënten:

Polling elk uur = 240 000 verzoeken/dag

Detectie met gemiddelde vertraging van 30 minuten

Officieel quotum vaak bereikt

Met een webhook-API ontvangt u één HTTP-melding wanneer de gebeurtenis zich voordoet.

3. Geen verrijkte UBO

De officiële API toont KBO-gegevens (onderneming, adres, bestuurders, NACE, vestigingen). Maar het UBO-register is een aparte dienst (MyMinFin), met:

Aparte eID-authenticatie

Geen publieke REST-API

Beperking tot handmatige raadpleging voor de meeste professionele toegangen

Voor een volledige KYC moet u KBO + UBO kruisen. De officiële API doet dat niet voor u.

4. Geen Peppol

Verifiëren of een onderneming geregistreerd is op Peppol (om haar een elektronische factuur te sturen) vereist het bevragen van een aparte directory (Peppol SMP/SML). Niet blootgesteld door de officiële API.

5. Geen developer support

De officiële API biedt geen:

Onderhouden OpenAPI/Swagger-documentatie

Test-sandbox

Developer-chat of -e-mail

Contractuele SLA

Publieke status (uptime, incidenten)

Hebt u een bug om 3 uur 's nachts op een vrijdag, dan staat u er alleen voor.

6. Geen business-verrijking

De officiële API toont ruwe gegevens. Geen:

Datakwaliteitsscore (gesignaleerde inconsistenties)

Berekende financiële indicatoren (bedrijfsomvang volgens EU-definitie)

Semantische full-text search

Geavanceerde filtering (op omzet, personeel, enz.)

Vestigingenkaart

Wijzigingsopvolging (timeline)

Wanneer de officiële API de juiste keuze blijft

Eerlijk gezegd zijn er gevallen waarin de officiële API ruimschoots volstaat:

Academisch project: studenten, onderzoek, scripties

Wekelijkse bulkverwerking: een zondagavondscript dat de full dump inneemt en in uw data warehouse schrijft

Zeer basis intern hulpmiddel: een scriptje dat 5 btw-nummers per dag verifieert

Backup / waarheidsbron: een API van derden kruisen met de officiële bron voor audit

In die gevallen zou een betalende API verspilling zijn.

Wanneer migreren naar een API van derden

Omgekeerd is migreren zinvol zodra:

U in productie staat met een cliënt-SLA: uw omzet hangt af van beschikbaarheid

U KYC of AML doet: nood aan UBO-cascade, archivering, traces

U Peppol-facturatie doet: verificatie van registratie en ontvangstcapaciteit

U wijzigingen opvolgt: monitoring, waarschuwingen, webhooks

U volume > 1000 req/dag hebt: de officiële SOAP begint vast te zitten

Uw team geen SOAP-competentie heeft: opleidingskost > API-kost

U OpenAPI / officiële SDK's wilt: onontbeerlijk voor nieuwe integraties

De verborgen kost van "gratis blijven"

Een eerlijke berekening over 12 maanden voor een productieproject:

Post	Officiële API	API van derden (200 €/maand)
Initieel dev (SOAP, parsing)	5 d × 600 € = 3 000 €	1 d × 600 € = 600 €
Polling (200 000 req/dag, infra)	80 €/maand × 12 = 960 €	0 €
SOAP-bugs (1 d/kwartaal)	4 × 600 € = 2 400 €	0 €
Handmatige UBO-cascade (KYC)	30 min/dossier × 200 dossiers = 6 000 €	0 €
API-abonnement	0 €	200 € × 12 = 2 400 €
Totaal	12 360 €	3 000 €

Het verschil is systematisch in het voordeel van de API van derden zodra de verborgen kosten worden meegeteld.

Hoe Company Belgium deze lacunes vult

Voor serieuze projecten biedt Company Belgium de stenen die ontbreken in de officiële API:

Modern REST/JSON met up-to-date OpenAPI-doc — zie de endpoints-referentie

Webhooks: ontvang een melding zodra een onderneming wijzigt (nieuwe bestuurder, neerlegging van rekeningen, wijziging maatschappelijk doel, UBO-aangifte)

Automatische UBO-cascade, gekruist met het UBO-register

Geïntegreerde Peppol-check

SDK's Python / Node.js / TypeScript (zie de Python-tutorial)

Contractuele SLA op betalende plannen

Caching, transparante rate limits — zie de referentie-architectuur

Alles, terwijl gesynchroniseerd blijven met de officiële KBO (zodat de wettelijke waarheidsbron niet verloren gaat).

Samenvatting

De officiële API blijft een essentieel hulpmiddel: het is de bron. Maar voor de meeste productieprojecten die meer doen dan btw-nummers lezen, legt ze een verborgen kost op (SOAP, polling, manuele kruisingen) die snel het tarief van een API van derden overschrijdt.

De goede reflex: starten met de officiële API als u prototypeert, dan migreren naar een verrijkte API zodra een echte cliënt een SLA verwacht. Het is geen ideologische keuze, maar een economische berekening.