# KvK Handelsregister

Wie staat achter een bedrijf of stichting? Zoeken is gratis via de website; de API vraagt een sleutel en kost geld per bevraging.

- Uitgever: Kamer van Koophandel
- Gebied: Nederland · Laagste detail: onderneming
- Periode: heden · Ververst: dagelijks
- Toegang: Betaald · Licentie: Voorwaarden KvK
- Koppelsleutels: KvK-nummer, RSIN
- Status: grijs
- URL: https://developers.kvk.nl

## Wat kun je ermee?
- **Wie zit er achter een stichting?.** Zoek bestuurders en vestigingsadres. Handig bij subsidie-onderzoek.
- **Netwerk van bv's.** Zoek welke ondernemingen dezelfde bestuurder of hetzelfde adres delen.

## Interessante koppelingen
- Welke organisaties krijgen subsidie van meerdere gemeenten? → [ams-subsidies](https://www.opendataindex.nl/bron/ams-subsidies.md) via naam → KvK-nummer. Zet de namen uit subsidieregisters om naar KvK-nummers; dan pas kun je registers betrouwbaar samenvoegen.

## Vergelijkbare bronnen
- [OpenKvK en commerciële diensten](https://www.kvk.nl): Herverpakte KvK-data, vaak met netwerkweergave, meestal betaald.

## API (REST (JSON), OpenAPI 3)

- Basis: https://api.kvk.nl/api
- Toegang: De Handelsregister-API's vragen een API-abonnement (6,40 euro per maand) en een sleutel in de kop apikey; zonder sleutel 401. Zoeken kost per bevraging niets, Basisprofiel, Vestigingsprofiel en Naamgeving 0,02 euro. Aanvragen via developers.kvk.nl/nl/apply-for-apis. De open datasets op opendata.kvk.nl werken zonder sleutel. (getest)
- Formaten: json
- Filteren: Geen querytaal: zoeken met losse parameters (naam, adres, nummers, type). Profielen haal je op met het nummer in het pad.; 

### Endpoints
- `GET /v2/zoeken`: Zoeken op naam, KvK-nummer, RSIN, vestigingsnummer, adres of plaats; geeft per treffer kvkNummer, vestigingsnummer, naam, adres, type en links naar de profielen. Gratis per bevraging (wel abonnement).
- `GET /v1/basisprofielen/{kvkNummer}`: Basisprofiel: naam, statutaire naam, handelsnamen, registratiedatum, SBI-activiteiten.
- `GET /v1/basisprofielen/{kvkNummer}/{eigenaar|hoofdvestiging|vestigingen}`: Eigenaar (RSIN, rechtsvorm), hoofdvestiging (adres, werkzame personen, websites) of de lijst van vestigingen.
- `GET /v1/vestigingsprofielen/{vestigingsnummer}`: Vestigingsprofiel: adressen, werkzame personen, activiteiten; geoData=true voor BAG-id en coördinaten.
- `GET /v1/naamgevingen/kvknummer/{kvkNummer}`: Alle namen: statutaire naam, naam, ook genoemd, handelsnamen per vestiging.
- `GET https://opendata.kvk.nl/api/v1/hvds/basisbedrijfsgegevens/kvknummer/{kvkNummer}`: Open dataset (EU High Value Dataset), zonder sleutel: startdatum, actief, insolventie, rechtsvorm, postcoderegio (2 cijfers) en SBI-activiteiten. Alleen bv's en nv's, zonder naam of persoonsgegevens.
- `GET https://opendata.kvk.nl/api/v1/hvds/jaarrekeningen/kvknummer/{kvkNummer}`: Open dataset jaarrekeningen, zonder sleutel: balans, winst-en-verliesrekening en kasstroom uit gedeponeerde XBRL-jaarrekeningen.

### Parameters
- `naam`: Zoeken: naam waaronder een vestiging of rechtspersoon handelt. (uit de beschrijving)
- `kvkNummer`: 8 cijfers (in het pad bij de profielen, als parameter bij zoeken). (uit de beschrijving)
- `rsin`: Zoeken: 9 cijfers. (uit de beschrijving)
- `vestigingsnummer`: 12 cijfers. (uit de beschrijving)
- `postcode`: Zoeken: alleen samen met huisnummer of postbusnummer. Ook straatnaam, huisnummer, huisletter, plaats. (uit de beschrijving)
- `type`: Zoeken: hoofdvestiging, nevenvestiging en/of rechtspersoon (herhaal de parameter). (uit de beschrijving)
- `inclusiefInactieveRegistraties`: Zoeken: ook uitgeschreven inschrijvingen (standaard false). (uit de beschrijving)
- `pagina`: Zoeken: 1 tot 100. (uit de beschrijving)
- `resultatenPerPagina`: Zoeken: standaard 10, hoogstens 100. (uit de beschrijving)
- `geoData`: Profielen: true voegt BAG-id, GPS- en RD-coördinaten toe. (uit de beschrijving)

### Velden (selectie, betaalde API en open dataset) (11)
`kvkNummer` string, `vestigingsnummer` string, `naam` string, `type` string, `actief` string, `sbiActiviteiten` lijst, `totaalWerkzamePersonen` integer, `rechtsvormCode` string, `datumAanvang` string, `insolventieCode` string, `postcodeRegio` integer

### Limieten en valkuilen
- Open datasets: één verzoek per minuut per IP-adres en een gedeelde limiet voor alle gebruikers samen (200 per 5 minuten voor basisbedrijfsgegevens, 150 voor jaarrekeningen). Een tweede aanroep binnen de minuut gaf 429, ook als die eerste naar robots.txt ging. (getest)
- Zoeken: hoogstens 100 resultaten per pagina en 100 pagina's. (uit de beschrijving)
- De open dataset bevat geen naam: koppel via het KvK-nummer uit een andere bron, bv. GLEIF (entity.registeredAs) of een subsidieregister. Voor ING Groep (33231073): NV, actief, gestart 21-01-1991, SBI 64210. (getest)
- Voorwaarden open datasets: CC BY 4.0, en verrijken zodat het naar een persoon herleidbaar wordt is niet toegestaan. Bulklevering is mogelijk (product KVK Handelsregister Open Data Set op kvk.nl). (uit de beschrijving)
- Er is een testomgeving (https://api.kvk.nl/test/api/…) met een kleine set fictieve data en een op de site gepubliceerde testsleutel; handig om je code te testen, niet voor echte gegevens. (uit de beschrijving)
- Gegevens van eenmanszaken en bestuurders zijn persoonsgegevens; niet-openbare velden (bezoekadres afgeschermd, telefoon) vragen extra autorisatie (IPA). (uit de beschrijving)
- robots.txt van api.kvk.nl gaf 403; developers.kvk.nl staat alles toe. (getest)

### Voorbeeld
```
https://opendata.kvk.nl/api/v1/hvds/basisbedrijfsgegevens/kvknummer/33231073
```


## Voorbeelden met echte cijfers (2)

Per voorbeeld de bevinding, de peildatum en de aanroep die precies deze cijfers ophaalt.

- **Opgeheven bedrijven (CBS-cijfers): 174 duizend in 2025, 2,1 keer zo veel als in 2007** (2025). Tabel 83149NED. [Voorbeeld](https://www.opendataindex.nl/voorbeeld/kvk-opheffingen-cbs)
  - `https://opendata.cbs.nl/ODataApi/OData/83149NED/TypedDataSet?$filter=BedrijfstakkenBranchesSBI2008%20eq%20'T001081'%20and%20substringof('JJ'%2CPerioden)&$select=Perioden,TotaalOpheffingenVanBedrijven_1`
- **Nieuwe bedrijven naar aantal werkzame personen (CBS-cijfers): 1 persoon of minder is het grootste deel, 91% in 2025** (2025). Tabel 83148NED. [Voorbeeld](https://www.opendataindex.nl/voorbeeld/kvk-oprichtingen-grootte-cbs)
  - `https://opendata.cbs.nl/ODataApi/OData/83148NED/TypedDataSet?$filter=BedrijfstakkenBranchesSBI2008%20eq%20'T001081'%20and%20Perioden%20eq%20'2025JJ00'&$select=k_1WerkzamePersoonOfMinder_2,k_2Tot10WerkzamePersonen_3,k_10Tot50WerkzamePersonen_4,k_50Tot250WerkzamePersonen_5,k_250WerkzamePersonenOfMeer_6`