KVK Handelsregister Basisprofiel API

Zoek basisgegevens van inschrijvingen op met het KVK-nummer. Bijvoorbeeld maatschappelijke activiteit, gegevens eigenaar/ hoofdvestiging, en een lijst van de vestigingen.

Endpoint

https://api.kvk.nl/api/v1/basisprofielen

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. 

Ga naar de Swagger-UI

Input

ParameterTypeDetails
kvkNummerstringNederlands KVK-nummer. Bestaat uit 8 cijfers.
geoDatabooleanGeodata wordt in output getoond wanneer de waarde "True" is. Default waarde is ''False".

Output

Basisprofiel

ParameterTypeDetails
kvkNummerstringNederlands KVK-nummer. Bestaat uit 8 cijfers.
indNonMailingstringDe onderneming wil geen ongevraagde reclame per post of verkoop ontvangen.
naamstringNaam onder Maatschappelijke Activiteit.
formeleRegistratiedatumstringDe datum waarop de onderneming bij de KVK in het Handelsregister is geregistreerd.
materieleRegistratieobjectStart- en einddatum (wanneer van toepassing) van de onderneming.
statutaireNaamstringDe naam van de onderneming wanneer er statuten geregistreerd zijn.
handelsnamenarrayAlle namen waaronder een onderneming of vestiging handelt (op volgorde van registreren).
sbiActiviteitenarrayCode beschrijving van SBI-activiteiten conform SBI 2008 (StandardIndustrial Classification). Geen maximum aan resultaten. Zie ook kvk.nl/sbi. Array bevat items met een sbiCode, sbiOmschrijving, indHoofdactiviteit.
linksarray1. Link naar de huidige bevraging
2. Link naar alle gerelateerde vestigingen.

Basisprofiel - hoofdvestiging

ParameterTypeDetails
vestigingsnummerstringVestigingsnummer. Uniek nummer dat bestaat uit 12 cijfers.
kvkNummerstringNederlands KVK-nummer. Bestaat uit 8 cijfers.
rsinstringRechtspersonen Samenwerkingsverbanden Informatie Nummer.
indNonMailingstringDe onderneming wil geen ongevraagde reclame per post of verkoop ontvangen.
formeleRegistratiedatumstringDe datum waarop de Vestiging bij de KVK in het Handelsregister is geregistreerd. 
materieleRegistratieobjectStart- en einddatum (wanneer van toepassing) van de onderneming.
eersteHandelsnaamstringDe naam waaronder een onderneming of vestiging handelt.
indHoofdvestigingstringHoofdvestiging (Ja/Nee).
indCommercieleVestigingstringCommerciële vestiging (Ja/Nee).
voltijdWerkzamePersoneninteger 
totaalWerkzamePersoneninteger 
deeltijdWerkzamePersoneninteger 
handelsnamenarrayAlle namen waaronder een onderneming of vestiging handelt (op volgorde van registreren).
adressenarrayLijst met adressen. Zie Adres tabel voor structuur.
websitesarrayWebsites geregistreerd onder de hoofdvestiging.
sbiActiviteitenarrayCode beschrijving van SBI-activiteiten conform SBI 2008 (Standard Industrial Classification). Geen maximum aan resultaten. Zie ook kvk.nl/sbi. Array bevat items met een sbiCode, sbiOmschrijving, indHoofdactiviteit.
linksarray1. Link naar de huidige bevraging.
2. Link naar alle vestigingen (op basis van KVK-nummer).
3. Link naar basisprofiel (op basis van KVK-nummer).
4. Link naar vestigingsprofiel (op basis van vestigingsnummer).

Basisprofiel - eigenaar

ParameterTypeDetails
rsinstringRechtspersonen Samenwerkingsverbanden Informatie Nummer.
rechtsvormstringRechtsvorm van de organisatie/het bedrijf. Zie Mogelijke output van rechtsvormen.
uitgebreideRechtsvormstringRechtsvorm aangevuld met informatie over de structuur of rechtsbevoegdheid. Zie Mogelijke output van rechtsvormen.
adressenarrayZijn er vestigingen? Dan wordt "Adressen" getoond bij de hoofdvestiging. Zijn er geen vestigingen? Dan wordt "Adressen" getoond bij "Eigenaar". Zie Adres tabel voor structuur.
websitesarrayWanneer er geen hoofdvestiging is dan worden hier de websites getoond.
linksarray1. Link naar de huidige bevraging.
2. Link naar basisprofiel (op basis van KVK-nummer).

Basisprofiel - vestigingen

ParameterTypeDetails
kvkNummerstringNederlands KVK-nummer. Bestaat uit 8 cijfers.
aantalCommercieleVestigingeninteger 
aantalNietCommercieleVestigingeninteger 
totaalAantalVestigingeninteger 
vestigingenarrayDe betreffende vestigingen. Zie vestiging tabel voor structuur.
linksarray1. Link naar de huidige bevraging.
2. Link naar basisprofiel (op basis van KVK-nummer).

Vestiging

De datastructuur van een vestiging uit een Basisprofiel vestigingen bevraging.

ParameterTypeDetails
vestigingsnummerstringVestigingsnummer. Uniek nummer dat bestaat uit 12 cijfers.
eersteHandelsnaamstringDe naam waaronder een onderneming of vestiging handelt.
indHoofdvestigingstringHoofdvestiging (Ja/Nee).
indCommercieleVestigingstringCommerciële vestiging (Ja/Nee).
volledigAdresstringStraat, huisnummer, postcode en plaats.
linksarray1. Link naar de huidige bevraging.
2. Link naar basisprofiel (op basis van het KVK-nummer).

Adres

De datastructuur van een adres uit een Basisprofiel hoofdvestiging of Eigenaar bevraging.

ParameterTypeDetails
typestringCorrespondentie- en/of bezoekadres.
IndAfgeschermdstringAdres afgeschermd (Ja/Nee).
volledigAdresstringVolledig adres.
straatnaamstringStraatnaam.
huisnummerstringHuisnummer.
huisnummerToevoegingstringHuisnummer toevoeging.
huisletterstringHuisletter.
toevoegingAdresstringVrije tekst om een adres uitgebreid te omschrijven. Bijvoorbeeld wanneer men gevestigd is in een bedrijfsverzamelgebouw en er meerdere etages en/ of kamers zijn.
postcodestringPostcode.
postbusnummerintegerPostbusnummer.
plaatsstringPlaats. 
straatHuisnummerstringStraat/ huisnummer. 
postcodeWoonplaatsstringPostcode/ woonplaats. 
regiostringRegio. 
landstringLand. 
geoDataobjectBAG ID, GPS coördinaten en Rijksdriehoek-coördinaten.