Een nieuwe onderneming, een verhuizing, een andere naam of een nieuwe rechtsvorm is vaak het moment waarop een bedrijf nieuwe leveranciers kiest. De API volgt de accounts uit uw CRM in de Kruispuntbank van Ondernemingen (KBO), meldt elke wijziging per webhook en toont de ondernemingen die net zijn ingeschreven. Alleen bedrijfsgegevens: geen bestuurders, geen kapitaalwijzigingen.
Voor België komen de gebeurtenissen uit de wijzigingen in de KBO: naam, status, rechtsvorm en maatschappelijke zetel. U ontvangt ze als melding voor de accounts die u volgt of leest ze in de landenfeed. Elke rij is een event_type.
| Wijziging | event_type | Waarom verkoop kijkt |
|---|---|---|
| Nieuwe onderneming in de KBO | new_incorporation | Een startende onderneming kiest bank, boekhouder, verzekeraar, software en kantoor |
| Verhuizing van de maatschappelijke zetel | address_change | Nieuwe kantoren: verbouwing, inrichting, lokale dienstverleners |
| Nieuwe naam | name_change | Een rebranding opent contracten, systemen en drukwerk |
| Nieuwe rechtsvorm | legal_form_change | Een BV die NV wordt, groeit en herschikt haar contracten; een BVBA die BV wordt, past zich meestal alleen wettelijk aan (zie hieronder) |
| Stopzetting, ontbinding, vereffening | dissolution, liquidation | Stop de verkoop, bescherm de factuur, ruim het CRM op |
| Faillissement of reorganisatie | insolvency | Het register meldt de status; een apart insolventiebericht bestaat niet voor België |
| Heractivering | reactivation | De onderneming gaat weer verder na een reorganisatie of een faillissement |
Elke wijziging krijgt de datum waarop ze voor het eerst in de registergegevens verschijnt, niet de datum van de inschrijving: een nieuwe onderneming verschijnt enkele dagen na haar inschrijving. De geschiedenis begint op 30 september 2026; daarvoor bestaan geen gebeurtenissen. previous_value en new_value bevatten de oude en de nieuwe waarde: bij een verhuizing het oude en het nieuwe adres, bij een rechtsvormwijziging de KBO-codes. Vergelijk beide waarden: soms is het alleen een rechtgezette tikfout.
Let op de rechtsvorm. De KBO kent de oude BVBA (code 015) en de BV (code 610) naast elkaar. Een wijziging van 015 naar 610 is meestal de omzetting van de BVBA naar de BV van het Wetboek van vennootschappen en verenigingen en zegt weinig over groei: filter ze uit uw triggers.
De akten van oprichting en wijziging van vennootschappen, verenigingen en stichtingen worden bekendgemaakt in de bijlagen bij het Belgisch Staatsblad. Die akten zitten niet in deze data.
Zoek elke account één keer op ondernemingsnummer, abonneer ze en bewaar uw CRM-id als label: het komt terug in elke melding. Abonneren kost geen credits.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
# Uw accounts zoals het CRM ze kent: ondernemingsnummer en CRM-id
accounts = [('0417497106', 'crm-1001'), ('0400378485', 'crm-1002')]
for nummer, crm_id in accounts:
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'BE', 'company_number': nummer})
r.raise_for_status()
treffers = r.json()['data']
if treffers:
requests.post(f'{BASE}/monitor', headers=H, json={
'company_id': treffers[0]['id'],
'label': crm_id,
'events': ['corporate_event', 'status_change', 'dissolution'],
'webhook_url': 'https://uw-domein.be/hooks/prometiam',
}).raise_for_status()
Elke melding wordt ondertekend: de header X-Prometiam-Signature bevat sha256= en de HMAC-SHA256 van de body met het webhook_secret dat POST /monitor één keer teruggeeft. Controleer de handtekening voordat u de taak voor de accountmanager aanmaakt.
import hashlib
import hmac
def handtekening_klopt(body: bytes, header: str, webhook_secret: str) -> bool:
verwacht = 'sha256=' + hmac.new(webhook_secret.encode(), body, hashlib.sha256).hexdigest()
return hmac.compare_digest(header, verwacht)
# In de webhook-handler: lees de body ongewijzigd en controleer de header X-Prometiam-Signature.
# Maak daarna pas de taak aan: alert['label'] is uw CRM-id, alert['alert_type'] het soort melding;
# bij corporate_event noemt alert['detail'] het event_type, previous_value en new_value.
De webhook zit in elk plan. Op elk plan toont GET /monitor uw abonnementen en de 50 recentste meldingen, dus een nachtelijke job volstaat ook. Gevolgde ondernemingen worden dagelijks gecontroleerd. Volgen kan voor 3 ondernemingen in de proefperiode, 25 met Starter, 250 met Professional en 2.500 met Scale.
Voor het eerste gesprek zegt de wijzigingshistoriek meer dan de bedrijfsomschrijving: GET /company-events/search?country=BE&company_number=0417497106&date_from=2026-09-30 geeft de gebeurtenissen van die onderneming, de recentste eerst, aan 2 credits per aanroep. Een lege lijst betekent alleen dat er sinds het begin van de historiek geen wijziging is gezien.
Laat naam en nummer weg en dezelfde aanroep wordt de landenfeed: alle wijzigingen in België, de recentste eerst, te filteren op event_type. Hij reikt hoogstens 31 dagen terug (zonder date_from zeven dagen; een oudere datum weigert de API met 400), levert 100 gebeurtenissen per aanroep voor 2 credits en pagineert met next_cursor. Een dagelijkse of wekelijkse job die de feed leest en de ondernemingen van uw segment bijhoudt, vindt de accounts die u nog niet volgt.
# Alle verhuizingen van de maatschappelijke zetel van de afgelopen 7 dagen (100 gebeurtenissen per aanroep) curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=BE&event_type=address_change&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Bij een verhuizing staat in new_value het nieuwe adres met postcode en gemeente, zodat u op regio kunt filteren. Soms verdwijnt het adres (new_value is dan null). De company_id van elke gebeurtenis geeft u rechtstreeks door aan POST /monitor om de onderneming vanaf nu te volgen.
Een startende onderneming moet alles nog kiezen. Voor België gebruikt u founded_after: dat geeft de ondernemingen die sinds een datum zijn ingeschreven, zonder naam, met rechtsvorm, postcode, gemeente en provincie in het antwoord. U filtert dus zelf op wat u zoekt.
legal_form (BV, NV, VZW).activity_code) is bij de nieuwste inschrijvingen vaak nog leeg: filter op rechtsvorm, postcode of provincie en vraag het profiel later opnieuw op.import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
# Nieuwe BV's en NV's in de provincie Antwerpen sinds 12 oktober (blader met next_cursor voor de rest)
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'BE', 'founded_after': '2026-10-12', 'limit': 100})
r.raise_for_status()
for c in r.json()['data']:
if c['legal_form'] in ('BV', 'NV') and c['region'] == 'ANTWERPEN':
print(c['founding_date'], c['company_name'], c['postal_code'], c['municipality'])
Volgen kost geen credits: het plan bepaalt hoeveel ondernemingen u volgt. Een zoekopdracht kost 1 credit, een gebeurtenissenzoekopdracht en de landenfeed elk 2; fouten kosten niets. Starter kost 9,99 € per maand met 1.000 credits en 25 gevolgde ondernemingen, Professional 29,99 € met 10.000 credits en 250 ondernemingen, Scale 99,99 € met 50.000 credits en 2.500 ondernemingen; webhooks zitten in elk plan. De proefperiode duurt 14 dagen met 500 credits: een betaalkaart is vereist, tijdens de proefperiode wordt niets aangerekend; daarna loopt het Starter-plan tenzij u opzegt. Zie de prijzen.
Contains data from the Crossroads Bank for Enterprises (KBO/BCE), FPS Economy; see data_as_of for the date of the update. Prometiam is geen gecertificeerd uittreksel uit de KBO.
Rechtsbronnen: artikel XII.13 van het Wetboek van economisch recht en het koninklijk besluit van 4 april 2003, zoals aangehaald door de Gegevensbeschermingsautoriteit (gegevensbeschermingsautoriteit.be); voorwaarden van Public Search en Open Data: kbopub.economie.fgov.be.
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.