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.
Input
| Parameter | Type | Details |
|---|---|---|
| kvkNummer | string | Nederlands KVK-nummer. Bestaat uit 8 cijfers. |
| geoData | boolean | Geodata wordt in output getoond wanneer de waarde "True" is. Default waarde is ''False". |
Output
Basisprofiel
| Parameter | Type | Details |
|---|---|---|
| kvkNummer | string | Nederlands KVK-nummer. Bestaat uit 8 cijfers. |
| indNonMailing | string | De onderneming wil geen ongevraagde reclame per post of verkoop ontvangen. |
| naam | string | Naam onder Maatschappelijke Activiteit. |
| formeleRegistratiedatum | string | De datum waarop de onderneming bij de KVK in het Handelsregister is geregistreerd. |
| materieleRegistratie | object | Start- en einddatum (wanneer van toepassing) van de onderneming. |
| statutaireNaam | string | De naam van de onderneming wanneer er statuten geregistreerd zijn. |
| handelsnamen | array | Alle namen waaronder een onderneming of vestiging handelt (op volgorde van registreren). |
| sbiActiviteiten | array | Code 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. |
| links | array | 1. Link naar de huidige bevraging 2. Link naar alle gerelateerde vestigingen. |
Basisprofiel - hoofdvestiging
| Parameter | Type | Details |
|---|---|---|
| vestigingsnummer | string | Vestigingsnummer. Uniek nummer dat bestaat uit 12 cijfers. |
| kvkNummer | string | Nederlands KVK-nummer. Bestaat uit 8 cijfers. |
| rsin | string | Rechtspersonen Samenwerkingsverbanden Informatie Nummer. |
| indNonMailing | string | De onderneming wil geen ongevraagde reclame per post of verkoop ontvangen. |
| formeleRegistratiedatum | string | De datum waarop de Vestiging bij de KVK in het Handelsregister is geregistreerd. |
| materieleRegistratie | object | Start- en einddatum (wanneer van toepassing) van de onderneming. |
| eersteHandelsnaam | string | De naam waaronder een onderneming of vestiging handelt. |
| indHoofdvestiging | string | Hoofdvestiging (Ja/Nee). |
| indCommercieleVestiging | string | Commerciële vestiging (Ja/Nee). |
| voltijdWerkzamePersonen | integer | |
| totaalWerkzamePersonen | integer | |
| deeltijdWerkzamePersonen | integer | |
| handelsnamen | array | Alle namen waaronder een onderneming of vestiging handelt (op volgorde van registreren). |
| adressen | array | Lijst met adressen. Zie Adres tabel voor structuur. |
| websites | array | Websites geregistreerd onder de hoofdvestiging. |
| sbiActiviteiten | array | Code 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. |
| links | array | 1. 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
| Parameter | Type | Details |
|---|---|---|
| rsin | string | Rechtspersonen Samenwerkingsverbanden Informatie Nummer. |
| rechtsvorm | string | Rechtsvorm van de organisatie/het bedrijf. Zie Mogelijke output van rechtsvormen. |
| uitgebreideRechtsvorm | string | Rechtsvorm aangevuld met informatie over de structuur of rechtsbevoegdheid. Zie Mogelijke output van rechtsvormen. |
| adressen | array | Zijn er vestigingen? Dan wordt "Adressen" getoond bij de hoofdvestiging. Zijn er geen vestigingen? Dan wordt "Adressen" getoond bij "Eigenaar". Zie Adres tabel voor structuur. |
| websites | array | Wanneer er geen hoofdvestiging is dan worden hier de websites getoond. |
| links | array | 1. Link naar de huidige bevraging. 2. Link naar basisprofiel (op basis van KVK-nummer). |
Basisprofiel - vestigingen
| Parameter | Type | Details |
|---|---|---|
| kvkNummer | string | Nederlands KVK-nummer. Bestaat uit 8 cijfers. |
| aantalCommercieleVestigingen | integer | |
| aantalNietCommercieleVestigingen | integer | |
| totaalAantalVestigingen | integer | |
| vestigingen | array | De betreffende vestigingen. Zie vestiging tabel voor structuur. |
| links | array | 1. 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.
| Parameter | Type | Details |
|---|---|---|
| vestigingsnummer | string | Vestigingsnummer. Uniek nummer dat bestaat uit 12 cijfers. |
| eersteHandelsnaam | string | De naam waaronder een onderneming of vestiging handelt. |
| indHoofdvestiging | string | Hoofdvestiging (Ja/Nee). |
| indCommercieleVestiging | string | Commerciële vestiging (Ja/Nee). |
| volledigAdres | string | Straat, huisnummer, postcode en plaats. |
| links | array | 1. 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.
| Parameter | Type | Details |
|---|---|---|
| type | string | Correspondentie- en/of bezoekadres. |
| IndAfgeschermd | string | Adres afgeschermd (Ja/Nee). |
| volledigAdres | string | Volledig adres. |
| straatnaam | string | Straatnaam. |
| huisnummer | string | Huisnummer. |
| huisnummerToevoeging | string | Huisnummer toevoeging. |
| huisletter | string | Huisletter. |
| toevoegingAdres | string | Vrije tekst om een adres uitgebreid te omschrijven. Bijvoorbeeld wanneer men gevestigd is in een bedrijfsverzamelgebouw en er meerdere etages en/ of kamers zijn. |
| postcode | string | Postcode. |
| postbusnummer | integer | Postbusnummer. |
| plaats | string | Plaats. |
| straatHuisnummer | string | Straat/ huisnummer. |
| postcodeWoonplaats | string | Postcode/ woonplaats. |
| regio | string | Regio. |
| land | string | Land. |
| geoData | object | BAG ID, GPS coördinaten en Rijksdriehoek-coördinaten. |