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
Parameter | Type | Details |
---|---|---|
kvkNummer | string | Nederlands KVK-nummer. Bestaat uit 8 cijfers. |
Output
Parameter | Type | Detail |
---|---|---|
datumAanvang | string | De datum waarop de Maatschappelijke Activiteit in de echte wereld is ontstaan. |
actief | string | Indicator die aangeeft of de inschrijving actief of inactief is. J = Ja (actief). N = Nee (inactief). |
insolventieCode | string | Het soort bijzondere rechtstoestand; FAIL (Faillissement), SSAN (Schuldsanering), SURS (Surseance van betaling). |
rechtsvormCode | string | De rechtsvorm van de organisatie. Er zijn twee codes mogelijk: BV (Besloten Vennootschap). NV (Naamloze Vennootschap). |
postcodeRegio | string | Het regiodeel van de postcode van het bezoekadres. Dit zijn de eerste twee cijfers van de postcode. |
activiteiten | array | De verzameling van alle activiteiten van de organisatie. |
lidstaat | string | Lidstaat waar de organisatie gevestigd is. Dit is NL (Nederland). |
Activiteit
Parameter | Type | Details |
---|---|---|
sbiCode | string | De codering van de activiteit conform de SBI 2008. |
soortActiviteit | string | Geeft aan of een {Activiteit} een hoofdactiviteit of nevenactiviteit is van de Onderneming. De mogelijke codes zijn: Hoofdactiviteit. Nevenactiviteit. |