Met de Zoeken API haal je het KVK-nummer van een inschrijving op. Aanvullende gegevens vraag je vervolgens op met een van de andere API's.
https://api.kvk.nl/api/v2/zoeken
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.
Parameter | Type | Details |
---|---|---|
kvkNummer | string | Nederlands Kamer van Koophandel nummer dat bestaat uit 8 cijfers. |
rsin | string | Rechtspersonen Samenwerkingsverbanden Informatie Nummer dat bestaat uit 9 cijfers. |
vestigingsnummer | string | Vestigingsnummer dat bestaat uit 12 cijfers. |
naam | string | De naam waaronder een vestiging of rechtspersoon handelt. Dit kan zijn: actieve of vervallen statutaire naam, handelsnaam of naam. |
straatnaam | string | |
huisnummer | integer | Alleen in combinatie met postcode. |
huisletter | string | Alleen in combinatie met huisnummer. Kan slechts één letter bevatten. |
postcode | string | Mag alleen in combinatie met huisnummer of postbusnummer gezocht worden. |
postbusnummer | integer | Mag alleen in combinatie met postcode gezocht worden. |
plaats | string | |
type | string | Filter op type: hoofdvestiging, nevenvestiging en/ of rechtspersoon. Combineer met ‘&’. Voorbeeld : type=nevenvestiging&type=hoofdvestiging&type=rechtspersoon |
inclusiefInactieveRegistraties | boolean | Inclusief inactieve registraties met mogelijke waarden zijn “true” of “false”. Default waarde is “false”. |
pagina | integer | Minimaal 1 en maximaal 100. |
resultatenPerPagina | integer | Kies het aantal resultaten per pagina. Standaardwaarde is 10, maximum is 100. |
Parameter | Type | Details |
---|---|---|
resultaten | array | |
pagina | integer | Geeft aan op welke pagina je bent. Start vanaf pagina 1. |
resultatenPerPagina | integer | Aantal zoekresultaten per pagina. |
totaal | integer | Totaal aantal zoekresultaten gevonden. |
vorige | string | Link naar de vorige pagina wanneer beschikbaar. |
volgende | string | Link naar de volgende pagina wanneer beschikbaar. |
Parameter | Type | Details |
---|---|---|
kvkNummer | string | Nederlands KVK-nummer. Bestaat uit 8 cijfers. |
rsin | string | Wanneer RSIN ook input is. |
vestigingsnummer | string | Vestigingsnummer dat bestaat uit 12 cijfers. |
naam | string | De naam waaronder een vestiging of rechtspersoon handelt. In dit veld staat de (statutaire) naam of de eerste handelsnaam. Heb je in de zoekopdracht gezocht op een naam die niet de statutaire of eerste handelsnaam is, dan tonen we hier de handelsnaam waarop je hebt gezocht. |
adres | Adres | Binnenlands of Buitenlands adres. |
straatnaam | string | Straatnaam. |
huisnummer | integer | Wanneer postcode en huisnummer ook input zijn. |
huisletter | string | Wanneer postcode en huisnummer ook input zijn. |
postcode | string | Wanneer postcode en huisnummer ook input zijn. |
plaats | string | Plaats. |
type | string | Hoofdvestiging, nevenvestiging en/ of rechtspersoon. |
actief | string | Geeft aan of een bedrijf/vestiging/rechtspersoon is ingeschreven (Ja) of uitgeschreven (Nee). |
vervallenNaam | string | Bevat de vervallen handelsnaam of statutaire naam waar dit zoekresultaat mee gevonden is. |
links | array | Er worden geen links getoond wanneer de uitschrijving voor 22 mei 2010 heeft plaatsgevonden en wanneer "actief" "false" is. 1. Link naar het eerste zoekresultaat. 2. Link naar Basisprofiel (op basis van KVK-nummer). 3. Link naar Vestigingsprofiel (op basis van Vestigingsnummer). |
Parameter | Type | Details |
---|---|---|
straatnaam | string | |
huisnummer | integer | |
huisletter | string | |
postbusnummer | integer | Postbusnummer wordt alleen getoond indien het een postadres betreft |
postcode | string | |
plaats | string |
Parameter | Type | Details |
---|---|---|
straatHuisnummer | string | Een combinatie van de straat en huisnummer. |
postcodeWoonplaats | string | Een combinatie van een eventuele postcode en woonplaats. |
land | string | De naam van het land waar het adres bevindt. |