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:

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

Example

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

Testdata

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

KVK NumberLegal Form
69599084Eenmanszaak
90004973Foutmelding
68727720NV
90004760NV
68750110BV
90001354BV
69599068Stichting
90000102Stichting
90006623Stichting
69599076VoF
KVK NumberLegal Form
90005414VoF
55344526Coöperatie
90002520Kerkgenootschap
90002490Onderlinge Waarborg Maatschappij
90002903Error message
90000749Vereniging van Eigenaars
90001745Maatschap
90003942Commanditaire Vennootschap
55505201Overige Privaatrechtelijke Rechtspersoon

Test data for Vestigingsprofiel

VestigingsnummerLegal form
38509504Eenmanszaak
38509520Eenmanszaak
37178598BV
37178601BV
990000541921BV
37143557NV
990064773193Stichting (geoData)
990064773207Stichting (geoData)
38509474VoF
38509490VoF
VestigingsnummerLegal form
990000216645VoF
990000821206VoF
37178605Cooperatie
990000246858Onderlinge Waarborg Maatschappij
990000637800Maatschap
990000008288Commanditaire Vennootschap
990000246530Commanditaire Vennootschap
990000768218Commanditaire Vennootschap
990000852070Commanditaire 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. 

Example calls

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