KVK Handelsregister Zoeken V3
De API Zoeken V3 gebruik je om het KVK-nummer en/of vestigingsnummer van een inschrijving op te zoeken. Met deze gegevens kun je vervolgens aanvullende informatie opvragen via een van de andere API’s: Organisatie, Vestigingen en/of Functionarissen.
Veelgestelde vragen
Het gebruik van de Zoeken V3 API is gratis. Vraag je gegevens op met één van de andere API's? Dan betaal je een bedrag per bevraging.
De gegevens uit de API Zoeken kunnen onvolledig of onjuist zijn, omdat de API gebruik maakt van een andere bron dan de overige API's. We raden daarom niet aan om de output te gebruiken voor het verzamelen of verwerken van data binnen je bedrijfsprocessen.
De Zoeken API is uitsluitend bedoeld om snel KVK-nummers en vestigingsnummers op te zoeken. Daarom is de API ook gratis. Met de andere API's zoek je meer informatie op en betaal je een bedrag per bevraging.
Ja. Dit zijn alle zoekmogelijkheden in de API KVK Handelsregister Zoeken.
- KVK-nummer
- RSIN
- Vestigingsnummer
- Naam
- Straatnaam en plaats
- Postcode en huisnummer
- Postcode en postbusnummer
- Postcode, huisnummer, en huisletter
- Postcode, huisnummer en huisnummertoevoeging
Postcode en huisnummer worden niet standaard in het zoekresultaat getoond, tenzij hier op wordt gezocht.
Met de Zoeken V3 API haal je het KVK-nummer van een inschrijving op. Aanvullende gegevens vraag je vervolgens op met een van de andere API's.
API Zoeken V3 werkt op dit moment niet zoals een Google zoekmachine. Alleen bij specifieke zoekopdrachten, compleet en zonder spelfouten, worden relevante zoekresultaten weergegeven
Ja. Je kunt maximaal 100 zoekresultaten bekijken.
Nee. Dit is niet mogelijk.
Nee, dat is op dit moment niet mogelijk.
Uitgeschreven vestigingen worden standaard uit de resultaten gefilterd. Wil je deze toch bekijken? Voeg dan “inactieveRegistraties” toe aan de query.
Naast inactieve vestigingen kun je ook filteren op type (hoofdvestiging, nevenvestiging of niet-natuurlijke persoon), pagina (paginanummer) en aantalPerPagina (het aantal resultaten per pagina, max 100).
Ja, de maximale lengte voor de straatnaam is 256 karakters.
Endpoint
https://api.kvk.nl/api/v3/zoeken
Niet-openbare en/of afgeschermde gegevens bekijken
API Zoeken V3 levert uitsluitend openbare gegevens. Nadat je een zoekresultaat hebt ontvangen, worden links getoond naar de andere API’s: Organisatie, Vestigingen en Functionarissen.
In deze API’s kun je, als je geautoriseerd bent, niet-openbare en/of afgeschermde gegevens opvragen. In de documentatie staat beschreven hoe je dit doet.
Swagger UI
Test de API met Swagger UI. Deze toont de functies en mogelijkheden, hoe je toegang krijgt en hoe je de API gebruikt. Ontdek op een interactieve en visuele manier hoe je de API het beste kunt inzetten voor jouw project.
Input
| Parameter | Details |
|---|---|
| kvkNummer | Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer. Nummer dat bestaat uit 8 cijfers. |
| rsin | Een door de KVK aan een rechtspersoon, personenvennootschap of rederij toegekend uniek nummer. |
| vestigingsnummer | Een uniek nummer door de KVK toegekend aan een vestiging. Nummer dat bestaat uit 12 cijfers. |
| naam | De naam die hoort bij een vestiging of niet natuurlijke persoon. |
| straatnaam | De straat van het adres. Mag alleen in combinatie met woonplaats gezocht worden. |
| woonplaats | De woonplaats van het adres betreft een door het bevoegde gemeentelijke orgaan als zodanig aangewezen en van een naam voorzien gedeelte van het grondgebied van de gemeente. Mag alleen in combinatie met straatnaam gezocht worden. |
| postcode | De in Nederland gangbare postcode voor een Nederlands postadres, bestaande uit een numeriek deel en een alfabetisch deel. Mag alleen in combinatie met huisnummer of postbusnummer gezocht worden. |
| huisnummer | Het huisnummer van het adres. Mag alleen in combinatie met postcode gezocht worden. |
| huisletter | De huisletter die door de gemeente is toegekend aan het huisnummer. Optioneel, alleen in combinatie met huisnummer. |
| huisnummerToevoeging | Een toevoeging van het adres bijvoorbeeld rood, bis, etc. Optioneel, alleen in combinatie met huisnummer. |
| postbusnummer | Het nummer van een postbus dat wordt gebruikt als postadres. Mag alleen in combinatie met postcode gezocht worden. |
| type | Filter op resultaat type: hoofdvestiging, nevenvestiging en/of niet natuurlijke persoon. |
| inactieveRegistraties | Inclusief inactieve registraties. |
| pagina | Paginanummer: minimaal 1 en maximaal 100. |
| aantalPerPagina | Kies het aantal resultaten per pagina: minimaal 1 en maximaal 100. |
Output
ZoekResultatenPagina
| Parameter | Details |
|---|---|
| pagina | Geeft aan op welke pagina je bent. Start vanaf pagina 1. |
| aantalPerPagina | Geeft het aantal zoekresultaten per pagina weer. |
| hits | Aantal hits gevonden voor deze zoekopdracht. |
| vorige | Link naar de vorige pagina (indien beschikbaar). |
| volgende | Link naar de volgende pagina (indien beschikbaar). |
| resultaten | Zie tabel - Resultaat |
| links |
Resultaat
| Parameter | Details |
|---|---|
| nonMailing | Indicator die aangeeft of de inschrijving haar adresgegevens beschikbaar stelt voor mailing-doeleinden. |
| kvkNummer | Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer. |
| rsin | Een door de KVK aan een rechtspersoon, personenvennootschap of rederij toegekend uniek nummer. |
| vestigingsnummer | Een uniek nummer door de KVK toegekend aan een vestiging. |
| naam | De naam die hoort bij een vestiging of niet natuurlijke persoon. Dit kan zijn: actieve of vervallen statutaire naam, handelsnaam of naam. |
| adres | Zie tabel - Adres. |
| type | Hoofdvestiging/nevenvestiging/niet natuurlijke persoon. |
| actief | Indicator die aangeeft of de inschrijving actief of inactief is. |
| vervallenNaam | Vervallen naam van een vestiging of een niet natuurlijke persoon |
| links |
Adres
| Parameter | Details |
|---|---|
| binnenlandsAdres | Zie tabel - binnenlandsAdres |
| buitenlandsAdres | Zie tabel - buitenlandsAdres |
Binnenlandsadres
| Parameter | Details |
|---|---|
| type | bezoekadres of postadres. |
| straatnaam | De straat van het adres. |
| huisnummer | Het huisnummer van het adres. |
| huisletter | De huisletter die door de gemeente is toegekend aan het huisnummer. |
| huisnummerToevoeging | Een toevoeging van het adres, bijvoorbeeld rood, bis etc. |
| postbusnummer | Het nummer van een postbus dat wordt gebruikt als postadres. Postbusnummer wordt alleen getoond indien het een postadres is. |
| postcode | De in Nederland gangbare postcode voor een Nederlands postadres, bestaande uit een numeriek deel en een alfabetisch deel. |
| woonplaats | De woonplaats van het adres betreft een door het bevoegde gemeentelijke orgaan als zodanig aangewezen en van een naam voorzien gedeelte van het grondgebied van de gemeente. |
Buitenlandsadres
| Parameter | Details |
|---|---|
| type | Bezoekadres of postadres. |
| straatnaamHuisnummer | Het gegeven straatnaam/huisnummer is een combinatie van de straatnaam en het huisnummer in het buitenland. |
| postcodePlaats | De postcode/plaats is de combinatie van een postcode en plaats in het buitenland. |
| land | Het land waar het adres zich bevindt. |