KVK-uittreksel opvragen of een API gebruiken?

Het zijn geen concurrenten

De vraag wordt vaak gesteld als een keuze, maar een uittreksel en een API-lookup lossen verschillende problemen op.

Een uittreksel is een document. De gewaarmerkte variant draagt een handtekening van de KVK en is daarmee bewijs: een notaris accepteert het, een bank accepteert het bij het openen van een zakelijke rekening, een aanbestedende dienst vraagt erom. De waarde zit in de waarmerking, niet in de gegevens.

Een API-lookup is data. Het antwoord is JSON dat je in een formulier kunt prefillen, tegen je database kunt aanleggen of in een risicoregel kunt gebruiken. De waarde zit in de verwerkbaarheid, niet in de bewijskracht.

Zodra je dat onderscheid maakt, is de keuze meestal duidelijk.

Wat je met een API-call terugkrijgt

Vrijwel alle openbare velden die op een uittreksel staan, zitten in een verrijkte lookup:

curl "https://api.kvkbase.nl/v1/lookup/68750110?enrich=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Dat geeft je de statutaire naam, de handelsnamen, de rechtsvorm, het vestigings- en postadres, de SBI-activiteiten, de inschrijfdatum, het aantal vestigingen, personeelsaantallen, websites, de status en eventuele insolventie. Voor BV’s en NV’s komt daar een afgeleid en tegen VIES gevalideerd btw-nummer bij.

Wat er niet in zit, en dat is een bewuste beperking: bestuurders, gevolmachtigden, aandeelhouders en gestort kapitaal. Heb je die nodig, bijvoorbeeld voor een UBO-onderzoek, dan is een uittreksel of de officiële KVK-route je bron. Wij kunnen dat gat niet dichten en doen daar geen beloftes over.

De verborgen kosten van de handmatige route

Bij lage volumes lijkt handmatig opzoeken gratis. Dat klopt tot ongeveer het punt waarop iemand het dagelijks doet.

Reken het door voor een sales- of onboardingteam dat twintig bedrijven per dag natrekt. Dat is twintig keer een tab openen, zoeken, het juiste bedrijf uit een lijst met vergelijkbare namen kiezen, en gegevens overtypen. Twee minuten per stuk is veertig minuten per dag, en overtypen introduceert fouten die je pas ontdekt als een factuur terugkomt.

Er is ook een verborgen fout in de handmatige route die niemand meet: het verkeerde bedrijf kiezen. Zoek op “Van der Berg Installatietechniek” en je krijgt zes inschrijvingen in vier plaatsen, waarvan er twee beëindigd zijn. Een mens kiest de bovenste. Een API-flow die op KVK-nummer werkt, kan die fout niet maken, en een autocomplete-veld dwingt de gebruiker een concrete inschrijving te kiezen in plaats van een naam in te typen.

Het echte argument voor de API is niet de prijs, het is dat de data gestructureerd binnenkomt en dat validatie automatisch gebeurt. Een verkeerd overgetypt KVK-nummer wordt in een API-flow direct een INVALID_KVK_NUMBER of een NOT_FOUND, en niet een factuur die drie weken later wordt afgekeurd.

Wil je dit in een webshop, dan doet een WooCommerce-integratie het invulwerk in de checkout. Voor een breder beeld van optimalisatie in het bestelproces is er checkout-optimalisatie met bedrijfsgegevens.

De gotcha bij dossiervorming

Sla je een API-response op als bewijs dat je een klant hebt gecontroleerd, bewaar dan de volledige response plus een timestamp, niet alleen de velden die je gebruikte.

Een compliance-audit vraagt niet “was dit bedrijf actief”, maar “wat wist je op het moment dat je de klant accepteerde”. Als je alleen isActive: true hebt opgeslagen zonder de rest, kun je achteraf niet aantonen dat je naar de juiste inschrijving keek. Een JSON-blob in een verification_snapshots-tabel is goedkoop en beantwoordt die vraag wel.

En wees eerlijk over wat het is: een API-snapshot toont dat je gecontroleerd hebt. Het is geen gewaarmerkt document, en als je toezichthouder daar expliciet om vraagt, moet je alsnog naar de KVK.

Praktische verdeling

Test eerst of de velden die je nodig hebt er ook echt in zitten. De gratis laag geeft 50 lookups per maand zonder creditcard, genoeg om tien echte klanten uit je eigen bestand te verrijken en te zien waar de data gaten heeft. Dat is een betrouwbaarder antwoord dan een veldenlijst in documentatie, omdat verrijkte velden zoals employees en websites niet bij elke inschrijving gevuld zijn.

De meeste organisaties gebruiken uiteindelijk beide. De API in elke geautomatiseerde flow, en een uittreksel bij de handvol klanten per jaar waar een document echt nodig is. Begin met de API voor het volume, en houd de uittrekselroute voor de uitzonderingen.