Overstappen op nieuwe API's

Per 1 april 2022 kun je de API's KVK Handelsregister Search en Profile niet meer gebruiken. We adviseren je om over te stappen op onze nieuwe API's. Op deze pagina lees je hoe je dat doet.

Waarom nieuwe API’s?

  • De nieuwe API's leveren data uit het vernieuwde Handelsregister systeem.
  • De nieuwe API's voldoen grotendeels aan de NL API Design Rules. Zie de handleiding voor meer informatie.

Applicatie aanpassen

Het is belangrijk dat je als developer zo snel mogelijk je applicatie aanpast aan de nieuwe Handelsregister API's. Alle informatie die je daarvoor nodig hebt staat in de mapping.

Download Mapping

Veelgestelde vragen

  • Omdat de oude API's Handelsregister Search en Profile anders werken dan de nieuwe API's hebben we een schema gemaakt waarin je precies kunt zien hoe de nieuwe API's werken.

    Met de API KVK Handelsregister Zoeken zoek je bedrijven op met bijvoorbeeld een handelsnaam en/of plaats. Elk zoekresultaat heeft een hypermedia-link naar de API KVK Handelsregister Basisprofiel (kan alleen bevraagd worden met KVK-nummer) en/of KVK Handelsregister Vestigingsprofiel (kan alleen bevraagd worden met het vestigingsnummer) voor het bevragen van meer informatie. Dit is binnen REST ook wel bekend als HATEAOS.

    Voorbeeld gebruik nieuwe API's
  • Deze oude API’s verdwijnen per 1 april 2022:
    • KVK Handelsregister Search
    • KVK Handelsregister Profile
    Dit zijn de nieuwe, vervangende API’s:
    • KVK Handelsregister Zoeken – zoek op KVK-nummer, straat, plaats of indicatie hoofd-nevenvestiging.
    • KVK Handelsregister Basisprofiel – algemene gegevens van een organisatie opvragen op basis van het KVK-nummer.
    • KVK Handelsregister Vestigingsprofiel – specifieke gegevens van een vestiging opvragen op basis van het vestigingsnummer.
  • Met de API KVK Handelsregister Search kon je zoeken én basisgegevens opvragen. Met de API KVK Handelsregister Zoeken kun je alleen zoeken. Gebruik de nieuwe API's KVK Handelsregister Basisprofiel of Vestigingsprofiel om informatie op te halen.

    Om privacy redenen is het niet meer mogelijk om te zoeken op huisnummer en/of postcode. Om dezelfde reden is vrij zoeken in alle velden op dit moment niet mogelijk.

    Meer over de verschillen tussen de API's Zoeken en Search
  • Met de API KVK Handelsregister Profile kon je uitgebreide bedrijfsgegevens opvragen. Dat kan nog steeds met de API KVK Handelsregister Vestigingsprofiel. Met de API KVK Handelsregister Basisprofiel kun je basisgegevens opvragen.

    Meer over de verschillen tussen de API's Basisprofiel, Vestigingsprofiel en Profile
  • Medio 2022 wordt het weer mogelijk om te zoeken op postcode en huisnummer. Dit zijn alle zoekmogelijkheden in de API KVK Handelsregister Zoeken:
    • KVK-nummer
    • RSIN
    • Vestigingsnummer
    • Naam
    • Straat en plaats
    • Postcode en huisnummer (nieuw)
    Postcode en huisnummer worden niet standaard in het zoekresultaat getoond, tenzij hier op wordt gezocht.
  • Zoeken werkt iets anders dan je gewend bent. Je zoekt eerst met de API KVK Handelsregister Zoeken een bedrijf op. De informatie haal je vervolgens op met de twee andere API's. De API KVK Handelsregister Basisprofiel werkt met het gevonden KVK-nummer. De API KVK Handelsregister Vestigingsprofiel werkt met het gevonden vestigingsnummer.
  • Standaard worden alleen actieve registraties getoond. Wil je ook inactieve registraties zien? Dan moet je de parameter 'inclusiefinactieveregistraties' gebruiken. Je ziet dan bij de zoekresultaten of de vestiging of rechtspersoon actief of inactief is.

    Als de gevonden vestiging of rechtspersoon inactief is, en uitgeschreven voor 22 mei 2010, dan kun je geen informatie ophalen.
  • De kosten zijn deels gelijk gebleven.
    • KVK Handelsregister Zoeken is gratis (bij KVK Handelsregister Search betaalde je € 0,008 per bevraging).
    • Als je KVK Handelsregister Basisprofiel of Vestigingsprofiel gebruikt dan betaal je € 0,016 per bevraging (bij KVK Handelsregister Profile betaalde je hetzelfde bedrag).

    Meer weten over tarieven? Check dan de productpagina’s op het Developer Portal.
  • Nee, deze API’s verdwijnen. Je kunt ze tot uiterlijk 31 maart 2022 gebruiken. Nieuwe klanten worden hier niet meer op aangesloten.