KVK Handelsregister Vestigingen
Met de API Vestigingen kun je specifieke informatie opzoeken over vestigingen, op basis van een KVK-nummer en vestigingsnummer.
Endpoint
https://api.kvk.nl/api/v1/vestigingen/kvknummer/{kvknummer}/vestigingsnummer/{vestigingsnummer}
Niet-openbare en afgeschermde gegevens
Om afgescherme gegevens te checken moet je autorisatie hebben. Daarna kan je geautoriseerd de api bevragen.
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. |
| vestigingsnummer | Een uniek nummer door de KVK toegekend aan een vestiging. Nummer dat bestaat uit 12 cijfers. |
| geoData | Voeg geodata toe aan het response. Geodata wordt in de output getoond wanneer de waarde “true” is. Default waarde is “false”. |
Output
Algemeen
Algemene informatie over de vestiging die in deze API is aangeroepen.
| Parameter | Details | Openbaar |
|---|---|---|
| vestigingsnummer | Een uniek nummer door de KVK toegekend aan een vestiging. Nummer dat bestaat uit 12 cijfers. | Ja |
| kvkNummer | Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer. Nummer dat bestaat uit 8 cijfers. | Ja |
| actief | Indicator die aangeeft of de inschrijving actief of inactief is. | Ja |
Vestigingen
Een vestiging is een gebouw of complex van gebouwen waar duurzame uitoefening van de activiteiten van een onderneming of rechtspersoon plaatsvindt.
| Parameter | Details | Openbaar |
|---|---|---|
| vestigingsnaam | De eerste handelsnaam van een commerciële vestiging of de naam van een niet-commerciële vestiging. | Ja |
| datumAanvang | De datum waarop de activiteiten van een onderneming of rechtspersoon in een gebouw of complex van gebouwen zijn begonnen. | Ja |
| datumEinde | De datum waarop de activiteiten van een onderneming of rechtspersoon in een gebouw of complex van gebouwen zijn gestaakt. | Ja |
| registratieTijdstipInschrijving | De datum en tijdstip van de eerste registratie van een vestiging in het Handelsregister. | Ja |
| registratieTijdstipUitschrijving | De datum en tijdstip van de registratie van opheffen van een vestiging in het Handelsregister. | Ja |
| ambtshalveUitschrijving | Indicatie die aangeeft of de vestiging ambtshalve is opgeheven. | Ja |
| soortVestiging | Geeft aan of deze vestiging een hoofdvestiging of een nevenvestiging is. | Ja |
| soortVestigingsactiviteiten | Geeft aan of deze vestiging een commerciële vestiging of een nietcommerciële vestiging is. | Ja |
| activiteitenomschrijving | De korte bondige omschrijving van de activiteiten die de vestiging uitoefent. De beschrijving bevat de nadere aanduiding van de commerciële activiteiten (commerciële vestiging) of de nadere aanduiding van de nietcommerciële activiteiten (nietcommerciële vestiging). | Ja |
| totaalWerkzamePersonen | Het totaal aantal werkzame personen bij een vestiging is de optelsom van aantal parttime en fulltime werkzame personen bij een vestiging. | Ja |
| parttimeWerkzamePersonen | Het aantal parttime werkzame personen bij een vestiging is het aantal natuurlijke personen dat minder dan 15 uur werkt bij een commerciële vestiging. | Ja |
| fulltimeWerkzamePersonen | Het aantal fulltime werkzame personen bij een vestiging is het aantal natuurlijke personen dat 15 uur of meer werkt bij een commerciële vestiging. | Ja |
| peildatumWerkzamePersonen | De datum waarop het aantal parttime en fulltime werkzame personen van de commerciële vestiging is geteld. | Ja |
| exporteert | De exportindicator geeft aan of de commerciële vestiging goederen of diensten vanuit Nederland naar het buitenland uitvoert. | Ja |
| importeert | De importindicator is een indicatie of de commerciële vestiging goederen of diensten vanuit het buitenland naar Nederland invoert. | Ja |
| VoortzettingVestiging | Zie tabel VoortzettingVestiging. | |
| Naamgevingen | Zie tabel Naamgevingen. | |
| Activiteiten | Zie tabel Activiteiten. | |
| Communicatiegegevens | Zie tabel Communicatiegegevens. | |
| Adres | Zie tabel Adres. |
VoortzettingVestiging
Een voortzetting vestiging vindt plaats wanneer een vestiging wordt voortgezet in een andere maatschappelijke activiteit.
| Parameter | Details | Openbaar |
|---|---|---|
| registratieTijdstipVoortzettingVestiging | Het tijdstip waarop de voortzetting vestiging bij de KVK in het Handelsregister is geregistreerd. | Ja |
| datumVoortzettingVestiging | De datum waarop de voortzetting vestiging heeft plaatsgevonden. | Ja |
Naamgevingen
De namen van een vestiging.
| Parameter | Details | Openbaar |
|---|---|---|
| naam | De naam die hoort bij een vestiging. | Ja |
| soortNaam | Geeft het soort naam van de vestiging aan: Handelsnaam, Naam, Ook genoemd, Statutaire naam. | Ja |
Activiteiten
De verzameling van alle activiteiten van een vestiging. De verzameling van activiteiten is te relateren aan de activiteitenomschrijving van de vestiging.
Activiteit bevat de SBI-code met bijbehorende omschrijving van die activiteit.
| Parameter | Details | Openbaar |
|---|---|---|
| sbiCode | De 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. | Ja |
| soortActiviteit | Geeft aan of een activiteit een hoofdactiviteit of nevenactiviteit is van de vestiging. | Ja |
Communicatiegegevens
De communicatiegegevens van een vestiging.
| Parameter | Details | Openbaar |
|---|---|---|
| soortCommunicatiegegeven | Bevat de waarden telefoonnummer, emailadres of internetadres. | Ja/Nee |
| internetadres | Het internetadres (WWW) waarop de vestiging via internet bereikbaar is. | Ja |
| telefoonnummer | Het telefoonnummer waarop de vestiging bereikbaar is. | Nee |
| emailadres | Het e-mailadres waarop de vestiging per e-mail bereikbaar is. | Ja |
Adres
Een adres geeft een locatie aan welke kan worden bezocht of waarnaar post kan worden verzonden.
| Parameter | Details | Openbaar |
|---|---|---|
| Bezoekadres | Zie tabel Bezoekadres. | |
| Postadres | Zie tabel Postadres. |
Bezoekadres
Het adres van een vestiging waarop deze fysiek bereikbaar is.
| Parameter | Details | Openbaar |
|---|---|---|
| bezoekadresAfgeschermd | Geeft aan of het bezoekadres, op basis van een afschermingsverzoek, afgeschermd is of niet. | Ja |
| soortAdres | Geeft aan welk soort adres het betreft: BinnenlandsAdres, BuitenlandsAdres, BinnenlandsPostbusAdres, VrijeLocatie, AdresOnbekend. | Ja/Nee |
| straatnaam | De straat van het adres. | Ja/Nee |
| straatnaamHuisnummer | Een combinatie van de straatnaam en het huisnummer in het buitenland. | Ja/Nee |
| huisnummer | Het huisnummer van het adres. | Ja/Nee |
| postcode | De in Nederland gangbare postcode voor een Nederlands postadres. | Ja/Nee |
| woonplaats | De woonplaats van het adres. | Ja/Nee |
Postadres
Het adres van een vestiging voor correspondentie.
| Parameter | Details | Openbaar |
|---|---|---|
| soortAdres | Geeft aan welk soort adres het betreft. | Ja |
| straatnaam | De straat van het adres. | Ja |
| postbusnummer | Het nummer van een postbus dat wordt gebruikt als postadres. | Ja |
| postcode | De in Nederland gangbare postcode. | Ja |
GeoData
Basisregistratie Adressen en Gebouwen gegevens uit het kadaster.
| Parameter | Details | Openbaar |
|---|---|---|
| gpsLatitude | GPS Breedtegraad. | Ja/Nee |
| gpsLongitude | GPS Lengtegraad. | Ja/Nee |
| rijksdriehoekX | Rijksdriehoek X-coördinaat. | Ja/Nee |
| rijksdriehoekY | Rijksdriehoek Y-coördinaat. | Ja/Nee |
| rijksdriehoekZ | Rijksdriehoek Z-coördinaat. | Ja/Nee |
Veelgestelde vragen
Je kunt de API Vestigingen onder andere gebruiken om de namen van een vestiging op te vragen, inzicht te krijgen in de activiteiten die een vestiging uitvoert, te achterhalen via welke communicatiegegevens een vestiging bereikbaar is en op welke locatie je de vestiging kunt bezoeken.
De API levert een set gegevens in REST JSON-formaat, zodat je deze direct kunt verwerken in je eigen systemen.
De gegevens van een vestiging zijn op zichzelf geen persoonsgegevens. Maar de API kan informatie bevatten die naar een persoon te herleiden is. In dat geval zijn het wel persoonsgegevens en gelden de privacyregels.
Sinds 25 mei 2018 geldt in de hele Europese Unie de Algemene Verordening Gegevensbescherming (AVG). Deze wet geldt voor alle organisaties die persoonsgegevens gebruiken of opslaan.
Gebruik je de API Vestigingen? Lees dan eerst goed de informatie van de Autoriteit Persoonsgegevens. Controleer ook of je voldoet aan belangrijke regels, zoals:
- je gebruikt gegevens alleen voor een duidelijk doel (doelbinding);
- je verzamelt niet meer gegevens dan nodig is (dataminimalisatie).
Heb je vragen of loop je tegen problemen aan? Vul dan het contactformulier in.
- Kies als onderwerp "API bevragingen".
- Vul je naam en e-mailadres in.
- Noteer bij het veld "API bevraging" dat het om de Pre-release API Vestigingen gaat en beschrijf je vraag of probleem.
- Verstuur het formulier.
We nemen zo snel mogelijk contact met je op.
Enkele weken na ingebruikname van de API plannen we een evaluatiegesprek in, om te kijken hoe de API bevalt. Tijdens dit gesprek komen onderstaande punten/ vragen aan bod.
Gebruik van API Vestigingen als alternatief voor API Vestigingsprofiel
- Wanneer je afnemer bent van API Vestigingsprofiel: hoe ervaar je API Vestigingen als vervanging?
- Welke functionaliteiten of gegevens mis je in API Vestigingen?
- Zijn er aspecten die juist verbeterd zijn ten opzichte van API Vestigingsprofiel?
Aansluitproces en onboarding
- Hoe heb je het aansluitproces (autorisaties en certificaten) ervaren?
- Hoe eenvoudig was het om de API te koppelen en werkend te krijgen?
- Waar liep je eventueel tegenaan tijdens de implementatie?
Gebruik van de API in de praktijk
- Hoe gebruik je de API momenteel?
- In welke processen heb je de API geïmplementeerd?
- Welke endpoints en datavelden zet je in?
- Mis je bepaalde gegevens of functionaliteiten die voor jouw gebruikssituatie waardevol zouden zijn?
Documentatie
- Was de documentatie volledig en duidelijk genoeg om met de API te werken?
- Welke informatie ontbreekt of kan beter worden toegelicht?
- Mist er informatie in de FAQ die voor jou relevant zou zijn?
Gebruikerservaring
- Hoe ervaar je de API in dagelijks gebruik (performance, stabiliteit, consistentie)?
- Zijn er verbeterpunten in de gebruiksvriendelijkheid of betrouwbaarheid?
- Overige tips of adviezen?