Migration Zoeken V1 to V2

HuisnummerToevoeging (house number addition) has been replaced with the search parameter huisletter (house letter). You use the search parameter huisletter in combination with the search parameter huisnummer (house number). In addition, the search parameter can only contain one letter. 

The search parameter handelsnaam (trade name) has been changed to naam (name), to make it clear that not only a trade name is shown in the output. The name can be a 'statutaire name' (statutory name), ‘handelsnaam’ or 'naam (niet-commercieel)' (not commercial name).

Previously, the PO box number was provided as a huisnummer (house number) search parameter. With V2, a postbusnummer (mailbox number) search parameter has been introduced for this purpose.

The attribute 'aantal' has been clarified and adjusted to 'resultatenPerPagina' (results per page).

The 'self' attribute displays the URL of the original API call so you can find or reuse it.

Searching for multiple types has changed. See the examples below for the differences.

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

De Zoeken API has been updated from version V1 to V2. Improvements have been made to make searching more easy and clear. Adjustments have been made to the query parameters and output domestic and foreign addresses, among other things.

Read more in the migration guide

Zoeken V1 will no longer be available from July 29, 2024. Do you want to continue using the Search API? Then we recommend that you switch to V2 before that date.

Read more in the migration guide

You can use Zoeken V1 and V2 side by side until V1 is phased out on July 29, 2024. From then on, only V2 will be available.

The migration manual describes how to switch from Zoeken V1 to V2. You can continue to use your current API Key.

Not at this moment. So you only need to make changes to the Search API.

Is your question not listed?

Contact us. You will receive a response from us within 5 working days.

Contact

Help us improve

We would like to know what you think about the Developer Portal and what could be improved. Sign up for the customer panel and share your thoughts.

Join customer panel