De officiële KVK API of KVKBase

Wij zitten op dezelfde bron

Er is geen tweede Handelsregister. De KVK is de bron van waarheid, wij bevragen die API zelf, en elk veld dat wij teruggeven komt daar of van VIES vandaan. De vraag is dus niet welke data beter is, maar wie het samenvoegwerk doet.

Een langere technische uitwerking van dezelfde vergelijking staat in de blogpost over de officiële KVK API tegenover KVKBase.

Wat de KVK API beter doet

Drie dingen, zonder omhaal.

Het is de autoriteit. Bij een geschil, een audit of een toezichthouder is “opgehaald bij de KVK API” een sterker antwoord dan “opgehaald bij een tussenpartij die de KVK bevraagt”. Als dat je situatie is, weegt dat zwaarder dan gemak.

Er zijn endpoints die wij niet doorverkopen. Ons aanbod is een selectie. Heb je iets nodig dat daarbuiten valt, dan is direct koppelen de enige route.

Geen tussenpartij. Een groot in-house team dat een eigen contract wil, een eigen SLA en een directe lijn bij storingen, moet daar niet iemand tussen zetten. Dat is een legitieme architectuurkeuze en geen gebrek aan vertrouwen.

Wat direct koppelen echt kost

Niet de EUR 0,02. De rekening komt in code.

Een compleet bedrijfsbeeld is bij de KVK meerdere calls: zoeken om van een naam naar een KVK-nummer te komen, het basisprofiel, het vestigingsprofiel voor adres- en vestigingsgegevens, en naamgeving voor statutaire en handelsnamen. Dat zijn losse responses die je zelf samenvoegt, met eigen foutafhandeling per call en een eigen beslissing over wat je doet als call drie faalt terwijl één en twee slaagden.

Daarbovenop komt btw. Het BTW-nummer staat niet in het Handelsregister. Je leidt het af als NL + KVK-nummer + B01, wat alleen klopt voor BV en NV, en daarna controleer je het bij VIES. VIES is SOAP, is regelmatig traag, en gaat per lidstaat los offline. Dat betekent retries, een cache, en een expliciet antwoord op de vraag wat je toont als VIES niets zegt in plaats van “ongeldig”. Dat laatste is de gotcha waar de meeste integraties op stukbreken: valid: false en “VIES was onbereikbaar” mogen in je UI nooit hetzelfde zijn.

Bij ons is dat één call. GET /v1/lookup/{kvkNumber} geeft het profiel plus vat met number, valid en validatedAt, en met ?enrich=true komen postadres, werknemersaantallen, websites, statutaire naam, handelsnamen en het aantal vestigingen mee.

Rekenen op volumes

Op het betaalde profielendpoint kost duizend opvragingen ongeveer EUR 26,40 per maand bij de KVK, tegen EUR 19 bij ons voor duizend lookups. Vijfduizend komt op ongeveer EUR 106,40 tegen onze EUR 49. Dat draait pas om als je zoveel via het gratis Zoeken-endpoint kunt afhandelen dat je profielopvragingen laag blijven, of als je zelf zo agressief cachet dat je opvragingen ver onder je gebruikersaantallen liggen.

Reken het door met je eigen cache-hitratio voordat je op de prijs beslist. Bij een goed gevulde eigen cache is direct koppelen vaak goedkoper dan het lijkt.

Wie direct moet koppelen

Koppel direct bij de KVK als je een in-house team hebt dat de integratie draagt, als je een eigen contract met de bron wilt, of als je endpoints nodig hebt die buiten ons aanbod vallen. Ook bij een controle waarbij een dag vertraging niet acceptabel is, bijvoorbeeld een faillissementscheck vlak voor uitlevering, is de bron zelf de veiligere keuze dan onze cache van 24 uur.

Kom je bij ons uit, dan is dat omdat je bedrijf en btw in één response wilt en het samenvoeg- en VIES-werk niet zelf wilt onderhouden.