KVK Handelsregister Open Dataset Basis Bedrijfsgegevens

Met deze API zoek je enkele basis bedrijfsgegevens van inschrijvingen op met het KVK-nummer. Bijvoorbeeld inschrijvingsdatum, postcode-regio en activiteiten. 

Goed om te weten

  • Dit product is geschikt voor bijvoorbeeld statistieken en analyses.
  • Deze dataset levert alleen gegevens van Besloten Vennootschappen (BV) en Naamloze Vennootschappen (NV).
  • De limiet is één bevraging per minuut. 
  • Het is ook mogelijk om de open dataset in bulk te krijgen. Lees meer over bulklevering

Wetgeving

  • De HVDS (High Value Data Set) bevat geen persoonsgegevens. Dit heeft tot gevolg dat de beschikbare dataset niet alle datavelden bevat die zijn omschreven in Uitvoeringsverordening 2023/138. Dit geldt voor de naam van de onderneming en het KVK-nummer. Van het vestigingsadres zijn alleen de eerste twee cijfers van de postcode onderdeel van de datasets. De naam van de onderneming, het KVK-nummer en het vestigingsadres kunnen niet in alle gevallen worden aangemerkt als persoonsgegeven. KVK kan dit niet per geval beoordelen en stelt deze gegevens daarom niet beschikbaar als onderdeel van de HVDS.
  • KVK stelt op basis van wetgeving waaronder de Wet Hergebruik Overheidsinformatie en Uitvoeringsverordening 2023/138 data beschikbaar als HVDS.
  • De HVDS wordt voor hergebruik beschikbaar gesteld onder de voorwaarden van de Creative Commons BY 4.0 licentie (CC BY 4.0). Dit is een wereldwijd gestandaardiseerde openbare licentie. Deze voorwaarden zijn van toepassing op het gebruik van de HVDS. Door gebruik te maken van de KVK Handelsregister Open Dataset Basis Bedrijfsgegevens worden deze voorwaarden door de gebruiker van de HVDS geaccepteerd.  Het is daarbij niet toegestaan om deze HVDS op een zodanige manier te verrijken waardoor de gegevens herleidbaar zijn naar een individueel persoon.

Endpoint

https://opendata.kvk.nl/api/v1/hvds/basisbedrijfsgegevens/kvknummer

OpenAPI Specificatie

Input

ParameterDetails
kvkNummerNederlands KVK-nummer. Bestaat uit 8 cijfers.

Output

ParameterDetail
datumAanvangDe datum waarop de activiteiten van een onderneming of rechtspersoon start of gestart is. Een datum met nullen is een onbekende datum. 
actiefIndicator die aangeeft of de inschrijving               
actief of inactief is.   
J = Ja (actief).   
N = Nee (inactief).
insolventieCodeHet soort bijzondere rechtstoestand;              
FAIL (Faillissement),              
SSAN (Schuldsanering),              
SURS (Surseance van betaling).
rechtsvormCodeDe rechtsvorm van de organisatie. Er zijn twee codes mogelijk:   
BV (Besloten Vennootschap).  
NV (Naamloze Vennootschap).
postcodeRegioHet regiodeel van de postcode van het               
bezoekadres. Dit zijn de eerste twee cijfers               
van de postcode.
activiteitenDe verzameling van alle activiteiten van de organisatie.
lidstaatLidstaat waar de organisatie gevestigd is. Dit is NL (Nederland).

 

Activiteit

ParameterDetails
sbiCodeDe SBI-code is een code (van maximaal 6 cijfers) voor de classificatie van activiteiten. De codering van de activiteit is conform de SBI classificatie bij CBS.
soortActiviteitGeeft aan of een activiteit een hoofdactiviteit of nevenactiviteit is van de onderneming.