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.
Hoe werkt het?
Gebruik onderstaande URL’s in je software om onze testomgeving te gebruiken.
- 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
Gebruik API key: l7xx1f2691f2520d487b902f4e0b57a0b197 om te authentiseren. De sleutel moet opgenomen worden in het apikey header veld.
Voorbeeld
curl https://api.kvk.nl/test/api/v2/zoeken?naam=test -H "apikey: l7xx1f2691f2520d487b902f4e0b57a0b197"
Testdata
KVK-nummers (en bijhorende rechtsvorm) die beschikbaar zijn voor testen.
KVK Number | Rechtsvorm |
---|---|
69599084 | Eenmanszaak |
90004973 | Foutmelding |
68727720 | NV |
90004760 | NV |
68750110 | BV |
90001354 | BV |
69599068 | Stichting |
90000102 | Stichting |
90006623 | Stichting |
69599076 | VoF |
KVK Number | Rechtsvorm |
---|---|
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 |
Testdata voor Vestigingsprofiel
Vestigingsnummer | Rechtsvorm |
---|---|
38509504 | Eenmanszaak |
38509520 | Eenmanszaak |
37178598 | BV |
37178601 | BV |
990000541921 | BV |
37143557 | NV |
990064773193 | Stichting (geoData) |
990064773207 | Stichting (geoData) |
38509474 | VoF |
38509490 | VoF |
Vestigingsnummer | Rechtsvorm |
---|---|
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
Maak je eigen zoek query door zoektermen toe te voegen in de parametervelden en check welke responses je krijgt van onze API’s.
Voorbeeld aanroepen
https://api.kvk.nl/test/api/v2/zoeken?naam=test&type=hoofdvestiging&plaats=Veendam&straatnaam=Rietdekkershof
of:
https://api.kvk.nl/test/api/v2/zoeken?type=nevenvestiging&resultatenPerPagina =4&pagina=2
Basisprofiel API
Haal basisprofielen op met een KVK-nummer. Deze basisprofiel REST resource bevat 3 sub-resources (wanneer van toepassing) die afzonderlijk aan te roepen zijn.
Eigenaar
Haalt velden op die onderdeel zijn van de eigenaar van het bedrijf. Een eigenaar kan een natuurlijk of niet-natuurlijk persoon zijn.
Aanroepen: https://api.kvk.nl/test/api/v1/basisprofielen/<KVKnummer>/eigenaar
Hoofdvestiging
Haalt alleen de verkorte gegevens van een hoofdvestiging op.
Aanroepen: https://api.kvk.nl/test/api/v1/basisprofielen/<KVKnummer>/hoofdvestiging
Vestigingen
Levert een lijst van vestigingen die onder dit bedrijf vallen.
Aanroepen: https://api.kvk.nl/test/api/v1/basisprofielen/<KVKnummer>/vestigingen
De eigenaar en hoofdvestiging sub-resources worden als ‘embedded’ resources opgenomen in de hoofdresource basisprofielen.
Voorbeeld aanroepen
https://api.kvk.nl/test/api/v1/basisprofielen/90003942
https://api.kvk.nl/test/api/v1/basisprofielen/90003942/vestigingen
Vestigingsprofiel API
Haalt een profiel voor een vestiging op, op basis van een vestigingsnummer.
Voorbeeld aanroep
https://api.kvk.nl/test/api/v1/vestigingsprofielen/990000246530
Naamgeving API
Vraag naamgegevens op van bedrijven uit het Handelsregister op basis van KVK-nummer.
Voorbeeld aanroep
https://api.kvk.nl/test/api/v1/naamgevingen/kvknummer/24330087