Van ondernemingsnummer naar een gecontroleerd bedrijfsprofiel uit de Kruispuntbank van Ondernemingen (KBO), in één REST-aanroep en met hetzelfde antwoordschema als voor 17 andere landen.
Wie in België een zakelijke klant aanneemt, moet kunnen aantonen dat die onderneming bestaat, onder welke naam en rechtsvorm ze actief is en of ze nog actief is. Voor financiële instellingen, accountants en boekhouders, vastgoedmakelaars en andere onderworpen entiteiten volgt dat uit de Belgische antiwitwaswet van 18 september 2017: het klantenonderzoek begint bij een betrouwbare identificatie van de rechtspersoon. In de praktijk wordt die identificatie vaak met de hand gedaan: iemand zoekt de onderneming op in de KBO Public Search, kopieert de gegevens en bewaart een schermafdruk.
Dat werkt voor tien klanten per maand, niet voor tien per dag. Een API haalt dezelfde officiële gegevens op in een vaste structuur, zodat uw onboardingflow, uw CRM of uw compliancetool ze zelf kan controleren en bewaren. Wie ook klanten buiten België heeft, krijgt voor elk ander land dat Prometiam dekt hetzelfde antwoordschema.
Twee aanroepen volstaan voor de basiscontrole. Zoek de onderneming op met haar ondernemingsnummer (zonder punten) en vraag daarna het volledige profiel op met de id uit het zoekresultaat. Voorbeeld met Anheuser-Busch InBev, 0417.497.106:
# 1. Zoek op ondernemingsnummer (zonder punten)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=BE&company_number=0417497106' \
-H 'Authorization: Bearer rk_live_...'
# 2. Volledig profiel, met de id uit het zoekresultaat
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/{id}' \
-H 'Authorization: Bearer rk_live_...'
Kent u het nummer niet, zoek dan op naam met name= of op btw-nummer met vat=. Wilt u een nummer eerst met de hand nakijken, gebruik dan de gratis KBO-nummer opzoeken. Na de onboarding houdt POST /monitor de onderneming in het oog:
curl -X POST 'https://api.prometiam.com/functions/v1/risk-api/monitor' \
-H 'Authorization: Bearer rk_live_...' \
-H 'Content-Type: application/json' \
-d '{"company_id": 123, "country": "BE"}'
U krijgt een webhook bij een wijziging van status, naam, rechtsvorm of maatschappelijke zetel, bij stopzetting of faillissement en bij een sanctietreffer. Wijzigingen worden gedateerd op het moment dat ze voor het eerst in de registergegevens verschijnen, niet eerder dan 30 september 2026.
| Veld | Betekenis |
|---|---|
company_name | Naam van de onderneming volgens de KBO |
company_number | Ondernemingsnummer |
status en local_status | Standaardstatus en de bewoordingen van het register zelf (actief, stopgezet, in faillissement) |
legal_form en local_legal_form | Standaardrechtsvorm en de Belgische rechtsvorm (bv. NV, BV) |
founding_date | Datum van oprichting of start volgens het register |
| adresvelden | Maatschappelijke zetel |
vat_number, vat_number_source | Btw-nummer (BE + ondernemingsnummer); bron register: het register bevestigt de btw-plicht |
lei | LEI-code, indien de onderneming er een heeft |
Een controle van een btw-nummer bij de Europese VIES-dienst doet u met GET /vat/{nummer}. Sanctiescreening van de onderneming of van namen die uw klant opgeeft, gebeurt met GET /sanctions/screen?name=... (beta, vanaf het plan Professional).
Voor registercontroles volstaat Starter (9,99 € per maand, 1.000 credits). Een onboarding met opzoeking, profiel en btw-controle kost ongeveer drie aanroepen per klant. Sanctiescreening en webhooks horen bij Professional (29,99 € per maand, 10.000 credits). De prijzen zijn openbaar en een jaarabonnement krijgt twee maanden korting. Bekijk de prijzen.
De data is een hulpmiddel voor uw eigen controle en geen gecertificeerd uittreksel uit de KBO. Voor een bewijsstuk met juridische waarde blijft u het officiële register raadplegen.
Start uw gratis proefperiode van 14 dagen · API-documentatie
De proefperiode duurt 14 dagen en omvat 500 credits. Een betaalkaart is vereist, tijdens de proefperiode wordt niets aangerekend; daarna loopt het Starter-plan (9,99 € per maand) tenzij u opzegt.