Testomgeving

Opvragen niet-openbare gegevens

Gebruik onderstaande URL’s in je software om onze testomgeving te gebruiken.

• KVK Handelsregister Zoeken V3 API: https://api-secure.preprod.kvk.nl/api/v3/zoeken 
• KVK Handelsregister Organisatie API: https://api-secure.preprod.kvk.nl/api/v1/organisatie/kvknummer/{kvknummer}
• KVK Handelsregister Vestigingen API: https://api-secure.preprod.kvk.nl/api/v1/vestigingen/kvknummer/{kvknummer}/vestigingsnummer/{vestigingsnummer} 
• KVK Handelsregister Functionarissen API: https://api-secure.preprod.kvk.nl/api/v1/functionarissen/kvknummer/{kvknummer}

API-key (Client ID) en Client secret

Om niet-openbare gegevens te kunnen opvragen heb je naast een API-key ook een Client secret nodig. Hieronder zie je welke API-key en Client secret je kunt gebruiken per autorisatieniveau. 

Certificaat

Om te kunnen testen met niet-openbare gegevens moet je een certificaat meesturen. Lees meer over de eisen waar een certificaat aan moet voldoen.

Acces token aanvragen

Het access token haal je op met onderstaande endpoint.

De token stuur je mee in de Authorization header bij alle volgende API aanroepen. Daarnaast moet ook het client certificaat worden meegestuurd, dat wordt gebruikt voor het opzetten van de mTLS verbinding.

Endpoint

https://api-secure.preprod.kvk.nl/auth/oauth/v2/token
Kopiëren

• Benader de endpoint met een POST. 
• Stuur mee als header: Content-Type - application/x-www-form-urlencoded
• Stuur mee in de body: grant_type=client_credentials&client_id=<clientid>&client_secret=<clientsecret>&scope=oob

Voorbeeld opvragen niet-openbare gegevens

curl https://api-secure.preprod.kvk.nl/api/v3/zoeken?kvknummer=42084128
--cert /pad/naar/client.crt \
--key /pad/naar/client.key \ 
-H "Authorization: Bearer <access-token>"
Kopiëren

Testdata

Zoeken V3 werkt mogelijk niet correct samen met de andere API's. Resultaten kunnen daardoor afwijken.