KVK Mutatieservice

With the KVK Mutatieservice API, you receive immediate notification when something changes in the Trade Register. You decide in advance for which target group you want to receive signals. 

Swagger

Test the API with Swagger-UI. It shows the functions and possibilities, how to get access and how to use the API.

Go to the Swagger-UI

Test environment

On the test environment, you can safely try out the API with test data.

How does it work?

With KVK Mutation Service, you collect the mutations yourself by means of three API requests. You need an API key for this. You use this to authenticate.

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

The API key must be included in the apikey header field. 

Example

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

Mock signals

With these mock signals, which pretend to be real signals, you can test whether your system responds properly. Every 5 minutes, 10 new signals are available. 

Production environment

Did everything go well on the test environment? Then you can test the signals on the production environment.

URL production environment omgeving: https://api.kvk.nl/api/v1/abonnementen 
API key production environment: To be received by customer

Endpoints

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

First, the technical subscription ID is retrieved. You only need to make this request once because the ID never changes. 

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

Enter ‘subscriptionId’ in the path to retrieve the available signals. Filter by ‘from’ and ‘to’ for a smaller set of signals.

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

Retrieve the details of a signal by adding the parameter ‘signalId’ to the path. 
Only meta information about the change is shown. More information is available via other KVK APIs or KVK products. 

Catalog

In the catalog you will find information about the signals. Such as which versions are available, when you receive signals and examples.

Download the catalog (in Dutch)

FAQ

Check out the FAQ's about KVK Mutatieservice.