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.
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.