KVK-nummer validatie API

Wil je in je eigen toepassing controleren of een KVK-nummer klopt, dan bel je de KVK-validator van GetApi aan. Je stuurt het 8-cijferige nummer op en de response bevat de status van de inschrijving.

Dit is wat je per nummer terugkrijgt:

of het nummer voorkomt in het Handelsregister
of de inschrijving actief is
of er een faillissement, schuldsanering of surseance loopt
de rechtsvorm (BV of NV)
de SBI-activiteiten van de inschrijving

Waar je het voor gebruikt

Drie terugkerende toepassingen in de praktijk.

Bij het toelaten van een klant

Controleer het nummer op het moment van registratie, voordat je een account of factuur aanmaakt.

Bij het aangaan van een relatie

Check vooraf of de andere partij nog actief is en of er een bijzondere rechtstoestand wordt vermeld.

Bij het indelen van bedrijven

Gebruik de SBI-activiteiten om bedrijven automatisch in te delen, zonder handmatige administratie.

Werkt het ook in je eigen code?

De API werkt met een simpele HTTP-aanroep. In PHP ziet een aanroep er zo uit:

$client = new \GuzzleHttp\Client();

$response = $client->post('https://api.getapi.nl/api/v1/validate/kvk', [
    'headers' => ['X-Api-Key' => '123'],
    'json'    => ['kvk_number' => '59581883'],
]);

echo $response->getBody();

In de documentatie staan ook voorbeelden voor JavaScript, Python en andere talen.

Veelgestelde vragen

Welke nummers kan ik controleren?

De open dataset bevat Besloten Vennootschappen (BV) en Naamloze Vennootschappen (NV). Een nummer dat daar niet in voorkomt, wordt als onbekend geretourneerd.

Waarom zie ik geen naam of adres?

De dataset bevat alleen bedrijfsgegevens. Naam, adres en het volledige nummer worden er niet in gedeeld. Je krijgt de status, rechtsvorm, eventuele insolventie en de SBI-activiteiten.

Hoe snel krijg ik een antwoord?

Een nummer dat al is opgevraagd, staat 30 dagen in de cache en wordt direct beantwoord. Een nieuw nummer haalt de status bij de bron op en is meestal binnen een seconde klaar.

Waar staat de bron?

De gegevens komen uit de open dataset Basis Bedrijfsgegevens die de Kamer van Koophandel beschikbaar stelt. Meer over de randvoorwaarden lees je op de site van de Kamer van Koophandel.

KVK-nummers valideren met een API