KVK Mutatieservice

Met de KVK Mutatieservice API krijg je direct een melding wanneer er iets verandert in het Handelsregister. Je bepaalt van tevoren voor welke doelgroep je signalen wilt ontvangen. 

Swagger

Test de API met Swagger-UI. Deze toont de functies en mogelijkheden, hoe je toegang krijgt en hoe je de API gebruikt.

Ga naar de Swagger-UI

Testomgeving

Op de testomgeving kun je met testdata de API veilig uitproberen.

Hoe werkt het?

Bij KVK Mutatieservice haal je zelf de mutaties op door middel van drie API-verzoeken. Je hebt daarvoor een API-key nodig. Je gebruikt deze om te authenticeren.

URL testomgeving: https://api.kvk.nl/test/api/v1/abonnementen 
API-key testomgeving: l7xx1f2691f2520d487b902f4e0b57a0b197 

De API-key moet opgenomen worden in het apikey header veld. Op die manier roep je het endpoint aan.

Voorbeeld

curl https://api.kvk.nl/test/api/v1/abonnementen -H "apikey: l7xx1f2691f2520d487b902f4e0b57a0b197"

Mock signalen

Met deze nep-signalen, die doen alsof ze echte signalen zijn, kun je testen of je systeem goed reageert. Elke 5 minuten zijn er 10 nieuwe signalen beschikbaar. 

Productieomgeving

Is alles op de testomgeving goed gegaan? Dan kun je de signalen testen op de productieomgeving.

URL productie omgeving: https://api.kvk.nl/api/v1/abonnementen 
API-key productie omgeving: Te ontvangen door afnemer

Endpoints

https://api.kvk.nl/v1/abonnementen/

Als eerste wordt het technische abonnement ID opgehaald. Dit verzoek hoef je maar één keer te doen omdat het ID nooit wijzigt. 

https://api.kvk.nl/v1/abonnementen/{abonnementId}

Vul in het pad ‘abonnementId’ in om de beschikbare signalen op te halen. Filter op ‘vanaf’ en ‘tot’ voor een kleinere set signalen.

https://api.kvk.nl/v1/abonnementen/{abonnementId}/signalen/{signaalId}

De details van een signaal haal je op door de parameter ‘signaalId’ toe te voegen aan het pad. 
Er wordt alleen meta-informatie getoond over de wijziging. Meer informatie is beschikbaar via andere KVK API’s of KVK producten. 

Catalogus

In de catalogus vind je informatie over de signalen. Zoals welke versies beschikbaar zijn, wanneer je signalen ontvangt en voorbeelden. 

Download de catalogus

FAQ

Bekijk de veelgestelde vragen over de KVK Mutatieservice op de FAQ pagina.