Test environment
Test our APIs for free! You don't need to implement or register anything. You can easily run different test scenarios with a small set of fictitious data.
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
curl https://api.kvk.nl/test/api/v1/zoeken?handelsnaam=test -H "apikey: l7xx1f2691f2520d487b902f4e0b57a0b197"
Testdata
KVK numbers (and corresponding legal form) available for testing:
KVK Number | Legal Form |
---|---|
69599084 | Eenmanszaak |
90004973 | Foutmelding |
68727720 | NV |
90004760 | NV |
68750110 | BV |
90001354 | BV |
69599068 | Stichting |
90000102 | Stichting |
90006623 | Stichting |
69599076 | VoF |
KVK Number | Legal Form |
---|---|
90005414 | VoF |
55344526 | Coöperatie |
90002520 | Kerkgenootschap |
90002490 | Onderlinge Waarborg Maatschappij |
90002903 | Error message |
90000749 | Vereniging van Eigenaars |
90001745 | Maatschap |
90003942 | Commanditaire Vennootschap |
55505201 | Overige Privaatrechtelijke Rechtspersoon |
Test data for Vestigingsprofiel
Vestigingsnummer | Legal form |
---|---|
38509504 | Eenmanszaak |
38509520 | Eenmanszaak |
37178598 | BV |
37178601 | BV |
990000541921 | BV |
37143557 | NV |
990064773193 | Stichting (geoData) |
990064773207 | Stichting (geoData) |
38509474 | VoF |
38509490 | VoF |
Vestigingsnummer | Legal form |
---|---|
990000216645 | VoF |
990000821206 | VoF |
37178605 | Cooperatie |
990000246858 | Onderlinge Waarborg Maatschappij |
990000637800 | Maatschap |
990000008288 | Commanditaire Vennootschap |
990000246530 | Commanditaire Vennootschap |
990000768218 | Commanditaire Vennootschap |
990000852070 | Commanditaire Vennootschap |
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.