- API
- REST met JSON, alleen GET: de KVK API is alleen-lezen. Zoeken (versie 2), Basisprofiel, Vestigingsprofiel, Naamgeving en de Mutatieservice (versie 1) staan onder api.kvk.nl/api.
- Authenticatie
- Een API-sleutel in de header apikey. Die krijg je na een abonnementsaanvraag via het Developer Portal, met een KVK-nummer en een tekenbevoegde die de overeenkomst tekent. Aansluiten duurt tot 7 werkdagen.
- Testen
- Een gratis testomgeving met fictieve data, zonder registratie, onder api.kvk.nl/test/api en met een openbare testsleutel. Elke bevraging in productie wordt gefactureerd, ook een test of een vergissing.
- Kosten bij KVK
- Een abonnement kost 6,40 euro per maand per API-sleutel. Zoeken is gratis; een Basisprofiel, Vestigingsprofiel of Naamgeving kost 0,02 euro per bevraging. De Mutatieservice kost 1.279 euro per jaar extra. De KVK API’s zijn vrijgesteld van btw.
- Limieten
- Maximaal 300.000 bevragingen per maand en 100 per seconde. Zoeken geeft maximaal 100 resultaten per pagina en 1.000 in totaal, en zoekt op hele woorden, zonder wildcards en zonder SBI-code.
- Wat er niet in zit
- Geen btw-nummer, geen bestuurders, tekenbevoegden of aandeelhouders, geen UBO-gegevens en geen historie. Een btw-nummer controleer je via VIES.
- Mutatieservice
- Geen webhook: je haalt signalen op. Er zijn 12 soorten signalen, van adres- en naamswijziging tot insolventie en beëindiging, beschikbaar binnen 15 minuten. Een signaal zegt welk deel veranderde, niet de nieuwe waarde.
- Beschikbaarheid en wijzigingen
- 99% beschikbaarheid, gemeten over 90 dagen. KVK kondigt het uitfaseren van een product 12 maanden vooraf aan, een grote wijziging 6 maanden en een tariefwijziging 2 maanden. Het einde van een API-versie staat ook in een Warning-header in de antwoorden.
- Voorwaarden
- API-sleutels zijn persoonlijk. Staat de non-mailing indicator aan, dan mag je de gegevens niet gebruiken voor direct marketing per post. Doorgifte van Handelsregistergegevens, zoals doorverkopen of via een eigen website laten opvragen, staat KVK niet toe.