Testomgeving
Test gratis onze API’s! Je hoeft niets te implementeren of registreren. Met een kleine set aan fictieve data kun je verschillende testscenario’s uitvoeren.
Opvragen openbare gegevens
Gebruik onderstaande URL’s in je software om onze testomgeving te gebruiken.
- KVK Handelsregister Zoeken V3 API: https://api.preprod.kvk.nl/api/v3/zoeken
- KVK Handelsregister Organisatie API: https://api.preprod.kvk.nl/api/v1/organisatie/kvknummer
- KVK Handelsregister Vestigingen API: https://api.preprod.kvk.nl/api/v1/vestigingen/kvknummer/{kvknummer}/vestigingsnummer/{vestigingsnummer}
- KVK Handelsregister Functionarissen API: https://api.preprod.kvk.nl/api/v1/functionarissen/kvknummer
API-key
Gebruik API key: l7xx1f2691f2520d487b902f4e0b57a0b197 om te authenticeren. De sleutel moet opgenomen worden in het apikey header veld.
Voorbeeld
curl https://api.preprod.kvk.nl/api/v3/zoeken?naam=test -H "apikey: l7xx1f2691f2520d487b902f4e0b57a0b197"
Testdata
Zoeken V3 werkt mogelijk niet correct samen met de andere API's. Resultaten kunnen daardoor afwijken.
Zoeken V3 API
| Scenario | KVK-nummer | Rechtsvorm |
|---|---|---|
| EMZ met 2 Vestigingen en Gevolmachtigden en Eigenaar Functionarissen. | 42084128 | Eenmanszaak |
| Stichting met afgeschermd telefoonnummer. Vestiging met afgeschermd bezoekadres. Functionaris met BSN en privégegevens. | 42422608 | Stichting |
| Rechtspersoon actief met 1 hoofdvestiging en 1 bestuurder. | 42264003 | BV |
| Rechtspersoon inactief met 1 hoofdvestiging | 42024440 | BV |
Organisatie API
| Scenario | KVK-nummer | Rechtsvorm |
|---|---|---|
| EMZ met 2 Vestigingen en Gevolmachtigden en Eigenaar Functionarissen. | 42084128 | Eenmanszaak |
| Stichting met afgeschermd telefoonnummer. Vestiging met afgeschermd bezoekadres. Functionaris met BSN en privégegevens. | 42422608 | Stichting |
| Rechtspersoon actief met 1 hoofdvestiging en 1 bestuurder. | 42264003 | BV |
| Rechtspersoon inactief met 1 hoofdvestiging en Bewaarder boeken en bescheiden en Bestuurder. | 42024440 | BV |
Vestigingen API
| Scenario | KVK-nummer | Vestigingsnummer | Rechtsvorm |
|---|---|---|---|
| EMZ met 2 Vestigingen (Nevenvestiging). | 42084128 | 000077675347 | Eenmanszaak |
| EMZ met 2 Vestigingen (Hoofdvestiging). | 42084128 | 000077120795 | Eenmanszaak |
| Hoofdvestiging met afgeschermd bezoekadres en telefoonnummer. | 42422608 | 000080690459 | Stichting |
| Rechtspersoon actief met 1 hoofdvestiging en 1 bestuurder. | 42264003 | 000079011411 | BV |
| Hoofdvestiging inactief. | 42024440 | 000076472558 | BV |
Functionarissen API
| Scenario | KVK-nummer | Rechtsvorm |
|---|---|---|
| EMZ met Gevolmachtigden en Eigenaar. | 42084128 | Eenmanszaak |
| Functionaris met een bestuurder inclusief BSN en geboortegegevens. | 42422608 | Stichting |
| Functionaris met een bestuurder met een bestuurder. | 42264003 | BV |
| Inactieve Rechtspersoon met Bewaarder boeken en bescheiden en Bestuurder. | 42024440 | BV |
Fair Use Policy
De testomgeving is gratis beschikbaar voor het ontwikkelen en testen van je koppeling.
Performance-, load- en stresstesten zijn niet toegestaan. Ook is de omgeving niet bedoeld voor grote aantallen automatische tests. Om de testomgeving voor iedereen goed beschikbaar te houden, geldt een limiet van maximaal 1 bevraging per seconde.
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
- 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
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.
| Autorisatieniveau | API-key | Client secret |
|---|---|---|
| IPA | l70ac0c60a59e446469995e88ccd691b82 | 71ceafc909364fc0ac924fd013af0a94 |
| IPP | l743ef4854c0a84dcc9c9c8581bd185756 | e8bc99be42264afdbe202113d4a77e09 |
| IPP (inclusief BSN) | l74dedf847dca5491bacbd4906c0bd04a2 | b56d505109334df48d7537f1af84c1f3 |
| IPA en IPP | l71543a19b656c412da4794078c7cf3830 | 11e3d51079ad45ca9710510f30aed770 |
| IPA en IPP (inclusief BSN) | l71afe099d3af14a32a3104b1aca51e38f | 546d10c3764f4ab88f635c5b00eacc8a |
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 (het uploaden van een certificaat is niet van toepassing bij testen).
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
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>"
Testdata
Zoeken V3 werkt mogelijk niet correct samen met de andere API's. Resultaten kunnen daardoor afwijken.
Zoeken V3 API en Organisatie API
| Scenario | KVK-nummer | Rechtsvorm |
|---|---|---|
| Stichting met afgeschermd telefoonnummer. Vestiging met afgeschermd bezoekadres. Functionaris met BSN en privégegevens. | 42422608 | Stichting |
Vestigingen API
| Scenario | KVK-nummer | Vestigingsnummer | Rechtsvorm |
|---|---|---|---|
| Hoofdvestiging met afgeschermd bezoekadres en telefoonnummer. | 42422608 | 000080690459 | Stichting |
Functionarissen
| Scenario | KVK-nummer | Rechtsvorm |
|---|---|---|
| EMZ met Gevolmachtigden en Eigenaar. | 42084128 | Eenmanszaak |
| Functionaris met een bestuurder incl. BSN en geboortegegevens. | 42422608 | Stichting |
| Functionaris met een bestuurder met een bestuurder. | 42264003 | BV |
| Inactieve Rechtspersoon met Bewaarder boeken en bescheiden en Bestuurder. | 42024440 | BV |
Testvoorbeelden
Zoeken V3
Haal het KVK-nummer of vestigingsnummer op met deze API. Check voor meer informatie de documentatie.
Voorbeeld aanroep
https://api-secure.preprod.kvk.nl/api/v3/zoeken?kvknummer=42084128
Zie ook de OpenAPI Specificatie.
Organisatie
Er is maar één parameter mogelijk: KVK-nummer. Check voor meer informatie de documentatie.
Voorbeeld aanroep
Volledig dataset: https://api-secure.preprod.kvk.nl/api/v3/zoeken?kvknummer=42084128
Sub-resource Maatschappelijk Activiteit: "https://api-secure.preprod.kvk.nl/api/v1/organisatie/kvknummer/42084128/maatschappelijke-activiteit"
Voor overige subresources zie de OpenAPI Specificatie.
Vestigingen
Er zijn twee parameters mogelijk en verplicht: KVK-nummer en vestigingsnummer. Check voor meer informatie de documentatie.
Voorbeeld aanroep
Volledig dataset: https://api-secure.preprod.kvk.nl/api/v1/vestigingen/kvknummer/42084128/vestigingsnummer/000077675347.
Zie ook de OpenAPI Specificatie.
Functionarissen
Er is maar één parameter mogelijk: KVK-nummer. Check voor meer informatie de documentatie.
Voorbeeld aanroep
Volledig dataset: https://api-secure.preprod.kvk.nl/api/v1/functionarissen/kvknummer/42084128
Gemachtigden: https://api-secure.preprod.kvk.nl/api/v1/functionarissen/kvknummer/42084128/gemachtigden
Voor overige subresources zie de OpenAPI Specificatie.
Veelgestelde vragen
IPA: Inzien Privé Adressen
Niet-openbare en afgeschermde woonadressen (privéadressen) van eigenaren, vennoten, maten en functionarissen afgeschermde bezoekadressen van bedrijven of organisaties telefoonnummers van bedrijven of organisaties.
IPP: Inzien Privacygevoelige Persoonsgegevens
Niet-openbare persoonsgegevens: geslacht, geboorteplaats en geboorteland van eigenaren, vennoten, maten en functionarissen. Het gegeven Burgerservicenummer ontvang je alleen als verwerking hiervan tot je wettelijke taak behoort.