Migratie Zoeken V1 naar V2

HuisnummerToevoeging is vervangen door de zoekparameter huisletter. De zoekparameter huisletter gebruik je in combinatie met de zoekparameter huisnummer. Daarnaast kan de zoekparameter slechts één letter bevatten.

De zoekparameter handelsnaam is aangepast naar naam, om duidelijk te maken dat er niet enkel een handelsnaam in de output wordt getoond. De naam kan een ‘statutaire naam’, ‘handelsnaam’ of ‘naam (niet-commercieel)’ zijn.

Voorheen werd het postbusnummer als huisnummer zoekparameter meegegeven. Bij Zoeken V2 is hier een postbusnummer zoekparameter voor geïntroduceerd.

Het attribuut ‘aantal’ is verduidelijkt en aangepast naar ‘resultatenPerPagina’.

Het attribuut ‘self’ geeft de URL van de originele API-aanroep weer, zodat je deze kunt terugvinden of hergebruiken.

Zoeken op meerdere types is veranderd. Zie onderstaande voorbeelden voor de verschillen.

• Zoeken API V2: kvknummer=12345678&type=hoofdvestiging&type=nevenvestiging
• Zoeken API V1:  kvknummer=12345678&type=hoofdvestiging,nevenvestiging

De Zoeken API is geüpdatet van versie V1 naar V2. Er zijn verbeteringen doorgevoerd waardoor zoeken makkelijker wordt en duidelijker. Er zijn o.a. aanpassingen gedaan aan de query parameters en output binnen- en buitenlandse adressen.

Lees meer in de migratiehandleiding

Zoeken V1 is vanaf 29 juli 2024 niet meer beschikbaar. Wil je de Zoeken API blijven gebruiken? Dan raden we je aan om voor die datum over te stappen op V2. 

Lees meer in de migratiehandleiding

Je kunt Zoeken V1 en V2 naast elkaar gebruiken totdat V1 wordt uitgefaseerd op 29 juli 2024. Vanaf dan is alleen V2 nog beschikbaar. 

In de migratiehandleiding staat beschreven hoe je overstapt van Zoeken V1 naar V2. Je kunt je huidige API-Key blijven gebruiken. 

Op dit moment niet. Je hoeft dus alleen wijzigingen uit te voeren voor de Zoeken API.