KVK Handelsregister¶

Artific Connect · KVK geeft een sleutel drie manieren om het Handelsregister te lezen: zoeken, het basisprofiel van een onderneming opvragen en het vestigingsprofiel van één vestiging. Je installeert hem vanaf de Marktplaats, net als elke andere bundel.

Wat je krijgt¶

Eén toolset, kvk, met de drie koppelingen, plus een skill die het model vertelt welk nummer wat identificeert en welke tool welke vraag beantwoordt.

Je eigen API-sleutel¶

Deze bundel vraagt bij het installeren om één ding: kvk_api_key, de eigen KVK-API-sleutel van je organisatie. Elke aanroep wordt afgerekend op de overeenkomst waar die sleutel bij hoort, en daarom is hij van jou en niet van de omgeving.

Geef hem op als inloggegeven van het soort api key, in de header apikey:

{ "type": "api_key", "placement": "header", "name": "apikey", "secret": "<jouw KVK-sleutel>" }

Zolang hij ontbreekt staat het abonnement op wacht op configuratie en wordt er niets geïnstalleerd. De sleutel wordt één keer geschreven en nooit teruggelezen.

Voordat het werkt¶

Je beheerder moet api.kvk.nl toestaan in het uitgaand verkeer van de sleutel. Het register staat in Nederland.

De drie tools¶

Tool	Vraag hem om	Geef hem
`api__kvk-zoeken`	treffers in het register	een naam, een KVK-nummer, een vestigingsnummer, of een postcode met huisnummer
`api__kvk-basisprofiel`	het profiel van één onderneming	haar `kvkNummer` van acht cijfers
`api__kvk-vestigingsprofiel`	het profiel van één vestiging	haar `vestigingsnummer` van twaalf cijfers

Zoek eerst zodra iets anders dan het nummer bekend is: het zoeken geeft beide nummers terug, en daar werken de andere twee mee.

Goed om te weten¶

Geverifieerd op 2026-09-24 op developers.kvk.nl: de productiehost is api.kvk.nl, zoeken is /api/v2/zoeken, en de sleutel gaat mee in de header apikey.
Niet bevestigd op de pagina's van de leverancier, en dus bij de eerste rooktest te bevestigen: of de twee profielen hun nummer in het pad krijgen (/api/v1/basisprofielen/{kvkNummer}, /api/v1/vestigingsprofielen/{vestigingsnummer}) of als queryparameter. Zo verstuurt deze bundel ze; de pagina noemt het nummer als verplichte invoer zonder te zeggen waar het hoort.
De KVK heeft ook een gratis testomgeving met een eigen sleutel. Wil je het proberen voordat je een overeenkomst tekent, dan kun je de geïnstalleerde koppelingen afsplitsen en naar die omgeving laten wijzen.
Het beeldmerk: de kaart van deze bundel gebruikt KVK's eigen vierkante beeldmerk, van kvk.nl, onder KVK's voorwaarden voor logogebruik (gecontroleerd op 2026-09-24).