Test environment

How it works

Use the following URLs in your software to use our test environment:

• KVK Handelsregister Zoeken API: https://api.kvk.nl/test/api/v1/zoeken
• KVK Handelsregister Basisprofiel API: https://api.kvk.nl/test/api/v1/basisprofielen
• KVK Handelsregister Vestigingsprofiel API: https://api.kvk.nl/test/api/v1/vestigingsprofielen
• KVK Handelsregister Naamgeving API: https://api.kvk.nl/test/api/v1/naamgevingen

Use API key: l7xx1f2691f2520d487b902f4e0b57a0b197 to authenticate. The key must be included in the apikey header field.

For example

Copy
curl https://api.kvk.nl/test/api/v1/zoeken?handelsnaam=test -H "apikey: l7xx1f2691f2520d487b902f4e0b57a0b197"

Testdata

KVK numbers (and corresponding legal form) available for testing:

Zoeken API

Create your own search query by adding search terms in the parameter fields and check which responses you get from our APIs. For example:

https://api.kvk.nl/test/api/v1/zoeken?handelsnaam=test&type=hoofdvestiging&plaats=Veendam&straatnaam=Rietdekkershof
or:
https://api.kvk.nl/test/api/v1/zoeken?type=nevenvestiging&aantal=4&pagina=2

Basisprofiel API

With the Basisprofiel API it is possible to retrieve company profiles based on a KVK number. This basisprofiel REST resource contains 3 sub-resources (if applicable) that can be called separately.
These sub-resources are:

Eigenaar (owner)

This sub-resource retrieves fields that are part of the company's owner. An owner can be a natural or non-natural person. This can be called as follows:
https://api.kvk.nl/test/api/v1/basisprofielen/<KVKnummer>/eigenaar

Hoofdvestiging (main branch)

This retrieves only the abbreviated data of a head office:
https://api.kvk.nl/test/api/v1/basisprofielen/<KVKnummer>/hoofdvestiging

Vestigingen (branches)

This gives a list of branches that fall under this company. This can be called as follows:
https://api.kvk.nl/test/api/v1/basisprofielen/<KVKnummer>/vestigingen

The eigenaar and hoofdvestiging sub-resources are included as embedded resources in the main resource basisprofielen.

Example calls:
https://api.kvk.nl/test/api/v1/basisprofielen/90003942
https://api.kvk.nl/test/api/v1/basisprofielen/90003942/vestigingen

Vestigingsprofiel API

With the Vestigingsprofiel API, a profile for a location can be retrieved based on a location number.

Example call:
https://api.kvk.nl/test/api/v1/vestigingsprofielen/990000246530

Naamgeving API

With this API you request name data of companies from the KVK Business Register based on KVK number.

Example call:
https://api.kvk.nl/test/api/v1/naamgevingen/kvknummer/24330087

Important to know

Within the Dutch government, a 'private key chain' is used for machine-to-machine communication. This means that your software needs to install a number of certificates. This is important because your software can then check whether there is really communication with KVK. You can read more about adding certificates in our section on installing TLS certificate.