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.

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

Testdata voor Vestigingsprofiel

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