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/v2/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/kvknummer

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

For example

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

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/v2/zoeken?naam=test&type=hoofdvestiging&plaats=Veendam&straatnaam=Rietdekkershof
or:
https://api.kvk.nl/test/api/v2/zoeken?type=nevenvestiging&resultatenPerPagina =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