KVK Handelsregister Vestigingen
Met de API Vestigingen kun je specifieke informatie opzoeken over vestigingen, op basis van een KVK-nummer en vestigingsnummer.
Veelgestelde vragen
Je kunt de Vestigingen API 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.
Je betaalt € 0,02 per bevraging. Gebruik je deze API in combinatie met de Organisatie API om (hoofd)vestigingsinformatie op te vragen? Dan betaal je € 0,04 per bevraging.
De API levert een set gegevens in REST JSON-formaat, zodat je deze direct kunt verwerken in je eigen systemen.
Via de Vestigingen API kun je niet-openbare en/of afgeschermde gegevens opvragen. Namelijk het telefoonnummer en afgeschermd bezoekadres. Hiervoor heb je IPA (Inzien Privé Adressen) autorisatie nodig.
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).
Een postadres wordt alleen geleverd wanneer dit afwijkt van het bezoekadres. Zie je in het response uitsluitend het bezoekadres? Dan betekent dit dat het postadres hetzelfde is als het bezoekadres.
Geodata, zoals rijksdriehoeken en gps-coördinaten wordt geregistreerd door BAG (Basisregistratie Adressen en Gebouwen). De Vestigingen API neemt deze data één op één over.
Als BAG bepaalde attributen niet heeft ingevuld, wordt het betreffende veld niet opgenomen in de response.
De Vestigingen API toont altijd de actuele gegevens. Wanneer je de API aanroept met een actief KVK-nummer en vestigingsnummer, dan ontvang je de vestigingsgegevens die op dat moment bij KVK bekend zijn.
Het is ook mogelijk om een KVK-nummer of vestigingsnummer op te vragen dat is uitgeschreven. In dat geval ontvang je de laatst bekende stand: de vestigingsgegevens die op het moment van beëindiging in het Handelsregister waren geregistreerd.
Het is mogelijk om zogeheten grote (XL) dossiers op te vragen (denk aan ABN-AMRO, Rabobank). Let wel op dat de response tijd van zo’n bevraging aanzienlijk hoger ligt dan wat je van ons gewend bent. Dit komt door de grote hoeveelheden regels aan data die teruggestuurd worden. Dit kan mogelijk leiden tot time-outs.
Het is niet mogelijk om de Vestigingen API in combinatie met KMS (KVK Mutatie Service) te gebruiken. De Vestigingen API is gebaseerd op Gegevenscatalogus 4.0 en levert data vanuit het DataLeveringsPlatform (DLP). KMS daarentegen is nog aangesloten op de Gegevenscatalogus 3.0.4. en baseert zijn signalen op wijzigingen in de Productstore.
Omdat beide producten op een andere databron zijn aangesloten, kan de rechtszekerheid van de signalen en de bijbehorende wijzigingen niet worden gegarandeerd. Daarom raden wij sterk af om op basis van een KMS-signaal de Vestigingen API te bevragen.
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.
Endpoint
https://api.kvk.nl/api/v1/vestigingen/kvknummer/{kvknummer}/vestigingsnummer/{vestigingsnummer}
Geodata
Wil je Geodata ontvangen, wanneer deze aanwezig zijn? Voeg dan een extra stukje code toe aan het endpoint.
https://api.kvk.nl/api/v1/vestigingen/kvknummer/{kvknummer}/vestigingsnummer/{vestigingsnummer}?geoData=true
Niet-openbare en/of afgeschermde gegevens bekijken
Standaard krijg je toegang tot openbare en niet-afgeschermde gegevens. Lees hoe je toegang krijgt tot niet-openbare gegevens.
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 niet-commercië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 niet-commerciële activiteiten (niet-commercië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 (in geval van een e-mailadres) of internetadres (in geval van een website). | 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. Dit betreft een bezoekadres of postadres.
| Parameter | Details |
|---|---|
| bezoekadresAfgeschermd | Geeft aan of het bezoekadres, op basis van een afschermingsverzoek, afgeschermd is of niet. |
| soortAdres | Geeft aan welk soort adres het betreft. Het adres kan één van de volgende soorten zijn:
|
| straatnaam | De straat van het adres. |
| straatnaamHuisnummer | Een combinatie van de straatnaam en het huisnummer in het buitenland. |
| aanduidingBijBinnenlandsAdres | De aanduiding die wordt gebruikt voor adressen die niet zijn voorzien van de gebruikelijke straatnaam en huisnummeraanduidingen. Mogelijke waarden zijn: bij, tegenover. |
| huisnummer | Het huisnummer van het adres. |
| huisletter | De huisletter die door de gemeente is toegekend aan het huisnummer. |
| huisnummerToevoeging | Een toevoeging van het adres bijvoorbeeld rood, bis, etc. |
| postbusnummer | Het nummer van een postbus dat wordt gebruikt als postadres. |
| postcode | De in Nederland gangbare postcode voor een Nederlands postadres, bestaande uit een numeriek deel en een alfabetisch deel. |
| postcodePlaats | De combinatie van een postcode en plaats in het buitenland. |
| woonplaats | De woonplaats van het adres betreft een door het bevoegde gemeentelijke orgaan als zodanig aangewezen en van een naam voorzien gedeelte van het grondgebied van de gemeente. |
| regio | Regio is een deel van het land (streek, provincie, etc.). |
| land | Het land waar het adres zich bevindt. |
| identificatieAdresseerbaarObject | De unieke BAG identificatie van een adresseerbaar object. Een adresseerbaar object is een verblijfsobject, een standplaats of een ligplaats. |
| identificatieNummeraanduiding | De unieke identificatie van de BAG nummeraanduiding. Een nummeraanduiding is een door het bevoegde gemeentelijke orgaan als zodanig toegekende aanduiding van een verblijfsobject, een standplaats of een ligplaats. |
| toevoegingAdres | Vrije tekst om een Adres nader aan te kunnen duiden. Het gaat hier bijvoorbeeld om bedrijfsverzamelgebouwen waarbij meerdere vestigingen op hetzelfde adres zitten en waarbij onderscheid gemaakt worden door een extra omschrijving van de locatie, bijvoorbeeld 3de verdieping kamer 315. |
| locatiebeschrijving | Vrije tekst wanneer er sprake is van een vrije locatie. |
| GeoData | Zie tabel GeoData |
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 |