KvK Handelsregister

Basisadres

https://api.kvk.nl/api

Endpoints 7

• GET/v2/zoekenZoeken 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.
• GEThttps://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.
• GEThttps://opendata.kvk.nl/api/v1/hvds/jaarrekeningen/kvknummer/{kvkNummer}Open dataset jaarrekeningen, zonder sleutel: balans, winst-en-verliesrekening en kasstroom uit gedeponeerde XBRL-jaarrekeningen.

Filteren uit de beschrijving

Geen querytaal: zoeken met losse parameters (naam, adres, nummers, type). Profielen haal je op met het nummer in het pad.

Parameters 10

Velden (selectie, betaalde API en open dataset) 11

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

Probeer het HTTP 200 · 429 ms · 16 okt

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

{
  "datumAanvang": "19910121",
  "actief": "J",
  "rechtsvormCode": "NV",
  "postcodeRegio": 11,
  "activiteiten": [
    {
      "sbiCode": "64210",
      "soortActiviteit": "Hoofdactiviteit"
    },
    {
      "sbiCode": "70101",
      "soortActiviteit": "Nevenactiviteit"
    }
  ],
  "lidstaat": "NL"
}

Ingekort antwoord, opgeslagen bij het oogsten. Klik op het adres voor het echte, actuele antwoord.