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.
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.
FAQ
Bekijk de veelgestelde vragen over de KVK Mutatieservice op de FAQ pagina.