Frequently asked questions
Can't quite figure it out? Below you will find answers to the most frequently asked questions about the Developers Portal and our APIs.
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:
This can be done in two ways (both free of charge):
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.
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.
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.
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.
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.
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.
No, this is not possible.
Searching for multiple types has changed. See the examples below for the differences.
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:
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 per API key for the connection. When you use an API you pay € 0,019 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.
With an extra API key, you can easily distinguish between administration, usage and billing.
An extra API key connection costs € 6 per month. When you use an API you pay € 0,019 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.
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.
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.
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.
Contact us. You will receive a response from us within 5 working days.
ContactWe 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