KVK zoeken API: bedrijven vinden op naam of nummer

KVK zoeken via de API

Kort antwoord

Met een zoek-API vind je bedrijven in het Handelsregister op naam, handelsnaam of KVK-nummer en krijg je een lijst met KVK-nummers terug. Het Zoeken-endpoint van de KVK is gratis per opvraging. Bij KVKBase is GET /v1/search voor lijsten en GET /v1/autocomplete voor zoeken-tijdens-typen; daarna haal je met het KVK-nummer het volledige profiel op.

Haal een API-key Bekijk de docs

cURL

# Zoek op naam
curl "https://api.kvkbase.nl/v1/search?q=acme&pageSize=5" \
  -H "Authorization: Bearer KEY"

Wat je terugkrijgt

Een zoekopdracht levert geen volledig bedrijfsprofiel op, maar een lijst treffers. Per treffer krijg je het KVK-nummer, de naam, de plaats en of de inschrijving actief is. Dat is bewust licht: zoeken is voor het vinden, het profiel is voor het weten.

{
  "results": [
    { "kvkNumber": "12345678", "name": "Acme B.V.", "city": "Amsterdam", "isActive": true }
  ],
  "total": 42,
  "page": 1,
  "pageSize": 10
}

Twee manieren om te zoeken

Lijst met paginering (/v1/search): voor een resultatenpagina of een batch. Je geeft q, page en pageSize mee.
Autocomplete (/v1/autocomplete): voor een veld waarin iemand typt. Kleinere responses, bedoeld voor veel aanroepen achter elkaar.

Het patroon dat werkt

De gebruiker typt een naam of nummer.
Je zoekt, met debounce, vanaf twee tekens.
De gebruiker kiest een treffer.
Je haalt met het KVK-nummer het volledige profiel op met de lookup-call en vult je formulier.

Wil je dit zonder code uit te proberen, gebruik dan de zoekpagina. Wil je het als veld in je eigen formulier, kijk dan naar de widget.

Wat zoeken niet doet

Zoeken zoekt op namen, niet op omschrijvingen van wat een bedrijf doet. “Bakkerij in Utrecht” vindt dus alleen bedrijven waarvan de naam daarop lijkt. Voor een lijst bedrijven per branche heb je SBI-codes nodig.

Meer over de hele API staat op de KVK API-pagina.

Veelgestelde vragen

Kan ik in de KVK API zoeken op handelsnaam?

Ja. Zoeken vindt inschrijvingen op statutaire naam en op handelsnaam, en geeft per resultaat het KVK-nummer, de naam en de plaats terug. Voor alle verdere gegevens haal je daarna het profiel op.

Wat kost zoeken in de KVK API?

Per opvraging niets: Zoeken is gratis. Je betaalt wel het maandabonnement van EUR 6,40 en EUR 0,02 per opvraging als je daarna een profiel ophaalt.

Hoe bouw ik een zoekveld met suggesties?

Gebruik een autocomplete-endpoint met een korte vertraging (debounce) van een paar honderd milliseconden en minimaal twee tekens. Toon naam, plaats en KVK-nummer, en haal het volledig profiel pas op als de gebruiker kiest.

Kan ik ook zonder account zoeken?

Ja, op KVKBase zoek je zonder account in het Handelsregister via de zoekpagina. Voor de API heb je een gratis API-key nodig.