KBO Open Data: handleiding voor ontwikkelaars

Wat KBO Open Data is

KBO Open Data is het gratis, officiële uittreksel van het register dat de FOD Economie bijhoudt. Het bevat alle actieve geregistreerde entiteiten en vestigingseenheden: het volledige bestand van 26 september 2026 telde 1.964.143 ondernemingen en 1.699.251 vestigingseenheden.

Het bevat alleen de huidige toestand, zonder historiek: als een onderneming verhuist, staat alleen haar nieuwe adres in het bestand.

Toegang krijgen

Maak een gratis account aan op het KBO Open Data-portaal en aanvaard de licentie. Anoniem downloaden kan niet. Eenmaal geregistreerd download je de bestanden via het portaal.

Geautomatiseerd downloaden via SFTP vraag je apart aan bij de FOD Economie, zoals beschreven in het officiële KBO Open Data-cookbook.

Full- en Update-bestanden

Elke dag verschijnen een Full-bestand en een Update-bestand, die elk 31 dagen beschikbaar blijven. Het Full-bestand is een volledige momentopname; het Update-bestand bevat de wijzigingen sinds het vorige Full-bestand. Sommige oudere documenten, waaronder de licentie, spreken nog van maandelijkse bestanden: ze zijn dagelijks sinds eind 2025.

De bestandsnamen bevatten een extractnummer, dat elke dag met één stijgt, en de datum. Het Update-bestand heeft dezelfde naam, eindigend op _Update.zip.

KboOpenData_0494_2026_09_26_Full.zip

Elke zip bevat een meta.csv met de datum van de momentopname, het extractnummer, het type extract (full of update) en de versie van het bestandsformaat, die aangeeft welke versie van het cookbook je moet lezen.

De bestanden en hun kolommen

Je hoeft niet alle bestanden in te laden: kies de bestanden die je toepassing nodig heeft.

Bestandsformaat

• Kommagescheiden waarden, tekst tussen dubbele aanhalingstekens, met een kopregel.
• Een leeg veld betekent: geen waarde.
• Datums staan in de vorm dd-mm-yyyy, niet in ISO 8601.
• Ondernemingsnummers staan in de vorm 0123.456.789 en nummers van vestigingseenheden in de vorm 2.123.456.789. EntityNumber-kolommen kunnen beide bevatten.

Update-bestanden toepassen

Update-bestanden vervangen gegevens per entiteit, niet per rij. Voor elke tabel bevat de zip een _delete-bestand en een _insert-bestand. Zodra er iets verandert aan een entiteit in een tabel, staat haar nummer in het delete-bestand, en staan al haar huidige rijen voor die tabel, gewijzigd of niet, in het insert-bestand.

1. Laad eerst een Full-bestand in.
2. Verwijder per tabel alle rijen van de nummers in <tabel>_delete.csv.
3. Voeg daarna alle rijen van <tabel>_insert.csv toe.
4. Vervang je codetabel door de code.csv uit de zip: Update-bestanden bevatten altijd de volledige codelijst.

-- for each table, e.g. denomination, after loading
-- denomination_delete.csv and denomination_insert.csv
BEGIN;
DELETE FROM denomination
  WHERE entity_number IN (SELECT entity_number FROM denomination_delete);
INSERT INTO denomination SELECT * FROM denomination_insert;
COMMIT;

Elk Update-bestand bouwt voort op het vorige: pas ze in volgorde toe. De bestanden blijven maar 31 dagen beschikbaar: loopt je import verder achter, begin dan opnieuw vanaf een Full-bestand.

Valkuilen om te vermijden

• Natuurlijke personen hebben geen zetel en geen rechtsvorm. Ze zijn goed voor ongeveer 39% van de ondernemingen (770.175 op 26 september 2026), en alleen hun vestigingseenheden hebben een adres. Maak joins op adressen en rechtsvormen optioneel.
• Eén entiteit, meerdere namen. Een onderneming kan een maatschappelijke naam, een afkorting en een commerciële naam hebben, elk in meerdere talen. In denomination.csv is de taal een getal (1 Frans, 2 Nederlands, 3 Duits, 4 Engels, 0 onbekend); in code.csv is het een lettercode.
• Bewaar codes als tekst. Rechtsvormen, rechtstoestanden en activiteitengroepen beginnen met nullen (014, 000, 006). Als getal opgeslagen komen ze niet meer overeen met code.csv.
• Drie NACE-BEL-versies naast elkaar. Een activiteitscode betekent pas iets samen met haar NaceVersion: NACE-BEL 2003, 2008 of 2025. 62010 bestaat bijvoorbeeld in de tabel van 2008, maar niet in die van 2003 of 2025.
• Geen Engelse omschrijvingen. code.csv omschrijft elke code in het Nederlands en het Frans, sommige in het Duits, en voorlopig geen enkele in het Engels.
• Adressen in twee talen. Straten en gemeenten bestaan alleen in het Nederlands en het Frans, en het land is leeg voor Belgische adressen.
• Bijkantoor-ID’s zijn geen officiële nummers. De Id van een bijkantoor is nergens anders bruikbaar, en namen en adressen kunnen bij bijkantoren horen. Laad je alleen ondernemingen en vestigingseenheden in, dan hebben die rijen niets om aan te hangen.
• Niemand typt het formaat met punten. Verwacht 0123456789, BE0123456789 of 0123.456.789, en normaliseer het nummer voor je zoekt.
• Het volume. In het volledige bestand van 26 september 2026 telt activity.csv alleen al ongeveer 34 miljoen rijen. Lees de CSV-bestanden als stream in plaats van ze in het geheugen te laden, en voorzie schijfruimte voor de zip, de uitgepakte bestanden en je database tegelijk.

Wat de licentie van je vraagt

• Vermeld de bron en de datum van de laatste bijwerking van de gegevens.
• Wijzig de gegevens niet en vervorm hun betekenis niet, en gebruik ze voor het doel dat je bij je registratie opgaf.
• Gebruik persoonsgegevens niet voor direct marketing. Dat geldt voor alle gegevens van ondernemingen die natuurlijke personen zijn.
• Voor de persoonsgegevens die je bewaart, ben je verwerkingsverantwoordelijke volgens de AVG en moet je verzoeken om inzage, verbetering en bezwaar behandelen.
• De licentie vervalt als je een jaar lang niets downloadt.

Dit is een samenvatting voor ontwikkelaars, geen juridisch advies. Lees de licentie (in het Frans) voor je de gegevens gebruikt.

KBO Open Data of CBE2JSON?

KBO Open Data blijft de beste keuze als je de volledige dataset zelf wilt bezitten of analyseren. CBE2JSON is gemaakt voor applicaties die de gegevens willen opzoeken zonder de importinfrastructuur te onderhouden.

Gerelateerde bronnen

• API-documentatie: endpoints, voorbeelden en foutcodes
• Plannen en prijzen
• Status van de dienst en beschikbaarheid over 90 dagen