Naar de inhoud
API BCEAPI BCEAPI voor Belgische ondernemingsgegevens
ToepassingenPrijzenDocumentatieSandboxAPI-sleutel
🇬🇧 English🇫🇷 Français🇳🇱 Nederlands🇩🇪 Deutsch🇪🇸 Español
API-sleutel
API BCE / Toepassingen / KYC/KYB bij het openen van een zakelijk account

🪪 KYC/KYB bij het openen van een zakelijk account

Wanneer een vennootschap bij jou een account opent, moet je weten wie ze is, waar ze gevestigd is en wie haar bestuurt. De API brengt die elementen samen uit officiële bronnen.

Het probleem#

Een account openen voor een vennootschap (fintech, marktplaats, B2B-platform, kantoor onderworpen aan de antiwitwasregels) betekent haar identiteit controleren, niet overnemen wat de aanvrager intikte. In de praktijk mengt het dossier schermafbeeldingen, een pdf-uittreksel van het register en met de hand ingegeven namen van bestuurders.

Met de API bouw je dat dossier op vanuit enkel het ondernemingsnummer, vergelijk je wat de aanvrager verklaart met wat de officiële bronnen zeggen, en schakel je een analist alleen in voor de verschillen.

De API-gegevens die antwoorden#

  • GET /enterprise/{num}: officiële benaming, rechtsvorm, status, juridische toestand, begindatum en maatschappelijke zetel.
  • GET /enterprise/{num}/denominations: alle benamingen, om een handelsnaam te koppelen aan de vennootschap die hem draagt.
  • GET /enterprise/{num}/roles: bestuurders, vertegenwoordigers en uiteindelijke begunstigden, gehaald uit de meest recente publicatie in het Belgisch Staatsblad (oprichting, benoeming, overdracht), met de referentie van die publicatie.
  • GET /vat/{vatNumber}: validatie van het btw-nummer bij VIES.
  • GET /enterprise/{num}/financial: de financiële samenvatting uit de bij de Nationale Bank neergelegde jaarrekeningen, als die bestaan.

Voorbeeldverzoek#

"tok-comment"># Identity: legal name, form, status, juridical situation, registered office
curl https://companybelgium.be/api/v2/enterprise/1033.022.383 \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
"tok-comment">
# Officers and beneficial owners extracted from the Moniteur belge
curl https://companybelgium.be/api/v2/enterprise/1033.022.383/roles \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
"tok-comment">
# VAT number through VIES
curl https://companybelgium.be/api/v2/vat/BE1033022383 \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"

Uittreksel van het antwoord van /enterprise/{num}/roles:

{
  "success": true,
  "data": {
    "enterpriseNumber": "1033022383",
    "status": "...",
    "source": {
      "refNumber": "...",
      "publicationDate": "...",
      "publicationTitle": "...",
      "publicationType": "..."
    },
    "roles": [
      {
        "fullName": "...",
        "entityType": "...",
        "roles": [
          "..."
        ],
        "ownershipPercentage": "...",
        "enterpriseNumber": "..."
      }
    ],
    "updatedAt": "..."
  },
  "timestamp": "...",
  "meta": {
    "responseTime": "..."
  }
}

Het veld status van dit antwoord is ok wanneer een publicatie werd gelezen, no_publication wanneer er geen bruikbare publicatie bestaat en extraction_failed wanneer het lezen mislukte. Met het blok source vind je de oorspronkelijke publicatie in het Belgisch Staatsblad terug.

Aanbevolen aanpak#

  • Vraag eerst het ondernemingsnummer en vul het formulier vooraf in vanuit de fiche: de aanvrager verbetert in plaats van te tikken.
  • Vergelijk de persoon die het account opent met de bestuurders die /enterprise/{num}/roles teruggeeft; een afwezigheid is geen weigering maar een punt om na te gaan (een gevolmachtigde kan optreden zonder bestuurder te zijn).
  • Weiger automatisch een onderneming die niet actief is, en stuur een abnormale juridische toestand naar een analist.
  • Archiveer het ruwe antwoord, de referentie van de publicatie en de datum van de call in het klantendossier.

Grenzen om te kennen#

  • Bestuurders en begunstigden worden automatisch gehaald uit publicaties in het Belgisch Staatsblad. Dit is niet het UBO-register van de FOD Financiën, dat de bron blijft om te raadplegen voor je wettelijke verplichtingen.
  • De extractie steunt op de laatste relevante publicatie: een wijziging die nog niet is gepubliceerd, verschijnt niet, en een extractie kan mislukken of onvolledig zijn.
  • Een onderneming zonder bruikbare publicatie geeft no_publication terug; wanneer de bron tijdelijk onbereikbaar is, kan het endpoint 502 antwoorden.
  • De API verifieert de identiteit van een natuurlijk persoon niet (identiteitsbewijs, selfie): ze documenteert de onderneming, niet de aanvrager.
  • Het resultaat ondersteunt een beslissing; het neemt die niet in jouw plaats en is geen juridisch advies.

Veelgestelde vragen#

Geeft de API de uiteindelijke begunstigden (UBO)?

Via GET /enterprise/{num}/roles geeft ze de bestuurders en begunstigden terug die automatisch uit het Belgisch Staatsblad zijn gehaald. Het is geen kopie van het officiële UBO-register van de FOD Financiën.

Waar komen de identiteitsgegevens van de onderneming vandaan?

Uit de officiële open data van de Kruispuntbank van Ondernemingen (KBO/BCE), gepubliceerd door de FOD Economie.

Kan de API dienen voor een antiwitwasdossier?

Ja, als gegevensbron om het dossier op te bouwen en te documenteren. De waakzaamheidsverplichtingen blijven de jouwe, en het officiële UBO-register moet worden geraadpleegd waar de wet dat vereist.

Aan de slag

Maak een sleutel aan in het ontwikkelaarsportaal en volg daarna de referentiedocumentatie voor elk vermeld endpoint.

API-sleutel aanvragenLees de documentatie

Referentiedocumentatie

  • Onderneming
  • btw-validatie

Andere toepassingen

  • Een klant of leverancier controleren voor je met hem werkt
  • Een CRM automatisch verrijken vanuit het ondernemingsnummer
  • Een btw-nummer valideren (VIES) bij het invoeren van een factuur
  • Ondernemingen opvolgen met webhooks

Op deze pagina

Het probleemDe API-gegevens die antwoordenVoorbeeldverzoekAanbevolen aanpakGrenzen om te kennenVeelgestelde vragenAan de slag
API BCEAPI BCE

Een ontwikkelaarsproduct van Espero-Soft Informatiques, gebouwd op officiële KBO/BCE-opendata.

Product

ToepassingenWaarom API BCEPrijzenFAQ

Ontwikkelaars

DocumentatieAPI-referentieAPI-playgroundWijzigingslogboekAPI-sleutel

Bedrijf

Gegevens, compliance en Peppol ↗Company Belgium ↗Espero-Soft ↗

Juridisch

Wettelijke vermeldingenAlgemene gebruiks- en verkoopvoorwaardenPrivacybeleidCookiebeleid
© 2026 Espero-Soft Informatiques SRL · Alle rechten voorbehouden.Gemaakt in België 🇧🇪