Frequently asked questions

With the API Handelsregister Zoeken you can search for a company by, for example, entering the trade name or place. Looking for more information? Each search result has a hypermedia link to the API Basisprofiel and/or Vestigingsprofiel, also known within REST as HATEAOS. Basisprofiel can only be requested with a KVK number and Vestigingsprofiel only with a location number. Check out our factsheets:

• Factsheet KVK Handelsregister Zoeken
• Factsheet KVK Handelsregister Basisprofiel
• Factsheet KVK Handelsregister Vestigingsprofiel

This can be done in two ways (both free of charge): 

1. Via our SwaggerUI with associated test data. 
2. Via your own software with our test API key: l7xx1f2691f2520d487b902f4e0b57a0b197. For more information, check out the testing documentation (Dutch only).

In the documentation you will find possible input and output fields per API.

No, this is not possible.

No, this is not possible.

No, this is not possible.

You use the API Basisprofiel to find all active trade names of the main location. To find out the trade names of all branches, use the API Vestigingsprofiel for each branch.

No. The APIs do not provide an overview of the mutations (historical data). Order the product History via the website of the Chamber of Commerce.

No, this is not possible.

No, this is not possible.

Yes, the limit is 300,000 queries per month at a rate of up to 100 per second.

Yes. These are all search options in the API KVK Handelsregister Zoeken:

• Chamber of Commerce number
• RSIN
• Location number
• Name
• Street and place
• Postal code and house number (new)

Postal code and house number are not shown by default in the search result, unless they are searched for.

You can use the Zoeken API to retrieve the KVK number of a registration. You can then request additional data using one of the other APIs.

API Zoeken currently does not work like a Google search engine. Relevant search results are only displayed for specific searches, complete and without spelling errors.

Yes. You can view a maximum of 1000 search results.

No, this is not possible.

No, that is not possible at the moment.

Deregistered locations are filtered out of the results by default. Do you want to view this anyway? Then add “includelnactiveRegistrations” to the query.

Yes, the maximum length for the street name is 256 characters.

Yes. This occurs when a company is registered in the commercial register as bankrupt and the branches are inactive. The SBI codes and other location information are then not visible.

If the entrepreneur has not specified the number of employees, the fields "Aantal voldtijd werkzame personen" (number of full-time employed persons) and "Aantal deeltijd werkzamen personen" (number of part-time employed persons) under the section informatie hoofdvestiging (information main establishment) are empty.

Yes. Please refer to the documentation for this.

You pay a monthly fee of € 6,20 per API key for the connection. When you use an API you pay € 0,02 per query (KVK Handelsregister Zoeken is free). 

Want to know more about rates? Then check the product pages on the Developer Portal.

Yes it is. As long as the API key is used within the same organisation.

With the WW code you can only log in to www.kvk.nl. On the Developer Portal you log in with your chosen username and password.

• Request a new API key: go to the Developer Portal, fill in all details and request an API key/connection. With one connection you can use all APIs (Zoeken, Basisprofiel, Vestigingsprofiel en Naamgeving).
• Request extra API key: login to My Developer Portal and request an extra API key.

With an extra API key, you can easily distinguish between administration, usage and billing.

An extra API key connection costs € 6,20 per month. When you use an API you pay € 0,02 per query (KVK Handelsregister Zoeken is free).

Want to know more about rates? Then check the product pages on the Developer Portal.

You can cancel an API subscription in writing. Send a letter to your Chamber of Commerce regional office or an email to: account@kvk.nl. Keep in mind that a letter will take longer to arrive and that this can result in an (extra) month transition and subscription costs.

The agreement continues until the last day of the following calendar month and ends thereafter. For example: if you cancel on November 2, the agreement will continue until December 31.

At the moment it is not possible to transfer an API subscription to another Chamber of Commerce number. You can cancel the old connection and then request a new one.

Please contact the Internal Sales department. Send an email to: account@kvk.nl or call: 088 585 34 34.

Please contact the Internal Sales department. Send an email to: account@kvk.nl or call: 088 585 34 34.

Yes, that's right.

View the sample invoice (Dutch only).

Go to reset-password and enter your username. You will receive an email with instructions on how to create a new password.

Contact the Chamber of Commerce Service Desk to request your username. Telephone number: 088 585 3030. We are available on working days between 08:30 and 17:00.

Go to reset-password and enter your username. You will receive an email with instructions on how to create a new password.

Login to the KVK Developer Portal and go to “My API keys”.

Your organization's administrator can add and remove accounts. The administrator account will be deleted by us when the contract is canceled.

Login to the KVK Developer Portal and go to “My details”. You can change your login and contact details here.

Login to the KVK Developer Portal and go to “My API keys”.

KVK Handelsregister Zoeken: https://api.kvk.nl/api/v2/zoeken
KVK Handelsregister Basisprofiel: https://api.kvk.nl/api/v1/basisprofielen
KVK Handelsregister Vestigingsprofiel: https://api.kvk.nl/api/v1/vestigingsprofielen
KVK Handelsregister Naamgeving: https://api.kvk.nl/api/v1/naamgevingen

TLS (in the past also called SSL) secures the connection between two computers. To get such a secure connection, you need a certificate, a TLS certificate. A certificate contains information about the certificate holder, the domain, the name of the authority that issued the certificate, the country in which the certificate was issued, and the period of validity. This ensures that your system communicates with the KVK.

Yes, provided the terms of the agreement and terms of use are observed. To sign an agreement, you must be registered in the trade register and be authorized to sign. This excludes private use.

Yes, that's possible.

Within a few working days after you have registered and signed and returned the agreement.

The payment method you choose for the KVK API is also used for other KVK payment processes. Your payment details are not shared with third parties.

KVK APIs are exempt from VAT. You will receive an invoice without VAT.

An update is announced at least 48 hours in advance through email from the KVK Servicedesk. It is difficult to indicate how often updates take place. New releases depend on the continued development of the KVK API. If you’re not getting these updates, but would like to, send us a request via our contact form.

On the status page you will find the current status of KVK products and services. We also send messages when there is a malfunction, adjustment or maintenance work. Sign up for updates.

The average response time is around 500 ms.

Via invoice or direct debit. Invoices are sent by post. Would you like to receive this digitally? Read more about digital invoices on our website.

A sample agreement, the service guarantee, and terms of use can be found at the terms of use.

People who are authorised to sign are allowed to perform certain tasks on behalf of a company, such as signing contracts, making purchases, or dispatching deliveries.       
A person can have full or limited authority to sign.

Below you can find who is authorised to sign per business.

No, the limit for Open Dataset APIs is separate from the limit for the other APIs.

No, your current API key gives you access to APIs that require a subscription. You do not need to take out a subscription to use the Open Dataset APIs. You can access them with a public API key.

You use the Open Dataset APIs for free. You do not need to sign up for a subscription.

The service guarantee only applies to APIs that require a subscription. This is not the case with the Open Datasets.

Yes, as a foreign customer you can use the Open Dataset APIs.

Yes, that is possible. When multiple changes are made in the Business Register within one submission, a single notification message with multiple modified details is generated.

You cannot expand or collapse the data blocks. If there has been a change in a record, the fields within the data block will be displayed. The "Branches" and "Deposits" data blocks will not show any fields if no change has occurred. The "Business", "Owner", and "Officers" data blocks always display the underlying fields, even if no change has been made. The J/N indicator shows which records have been changed.

No, you only receive a notification if there has been a change in a public record. After receiving this notification, you can decide to retrieve the updated data via the KVK API or the KVK Dataservice.

We provide the public data that changes in the Business Register in real-time. The exception to this is the Communication Data collection because the phone number and fax number is not public. In addition, we provide the e-mail address and website is not included in the signal message.

At the start of the subscription, you will receive a list of KVK numbers. This is the result of the desired population that you have compiled using population criteria. With this list (the population), you can then determine for which KVK numbers a product must be purchased. In order to prevent overload, it is agreed in consultation at what time the products can best be purchased.

Every year, 350,000 new registrations and 2,300,000 changes are processed in the Business Register. Half of these are changes of establishment. A third are changes of officials.

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.