Frequently asked questions

You request an API subscription and receive an API key. This key allows you to retrieve information about companies, such as their name, address, or KVK-number. 

With the "KVK Handelsregister Zoeken" API, you can search for a company by entering its trade name or location, for example. Each search result provides a link that allows you to request more information via other APIs. 

Want to know more? Check the API documentation.

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. Check the API documentation for more information. 

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). You can order the product History.

No, this is not possible.

No, this is not possible.

Yes, you can make up to 300,000 queries per month, and no more than 100 queries per second.

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

• KVK number
• RSIN
• Location number
• Name
• Street and place
• Postal code and house number

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 voltijd werkzame personen" (number of full-time employed persons) and "Aantal deeltijd werkzame 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.40 per API key for the connection. When you use an API you pay € 0.02 per query (KVK Handelsregister Zoeken is free). 

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.
• 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,40 per month. You also pay € 0,02 per query (KVK Handelsregister Zoeken is free).

You can cancel your API subscription in writing by sending an email to: account@kvk.nl. 

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 KVK 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.

If a government organization wants to use a KVK API, then querying data falls under input financing.

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 KVK 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 
KVK Mutatieservice: https://api.kvk.nl/api/v1/abonnementen/
KVK Handelsregister Open Dataset Basis Bedrijfsgegevens: https://opendata.kvk.nl/api/v1/hvds/basisbedrijfsgegevens/kvknummer 
KVK Handelsregister Open Dataset Jaarrekeningen: https://opendata.kvk.nl/api/v1/hvds/jaarrekeningen/kvknummer 

Yes, provided the terms of the agreement and terms of use are observed. To sign an agreement, you must be registered in the Business 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 in My KVK is also used for purchases through the Developer Portal. Your information will not be 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.

View the different payment options you can use at KVK.

A sample agreement, the service levels, 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 levels only apply 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.

• Een KVK-nummer dat nog niet bestaat (er is nog geen registratie in het Handelsregister) kan niet toegevoegd worden. 
• Een KVK-nummer van een bestaande registratie die nog niet tot de populatie behoort kan toegevoegd worden. 

Ben je geabonneerd op het signaal "Nieuwe Inschrijving"? Dan ontvang je een signaal als er een nieuw KVK-nummer (inschrijving in het Handelsregister) is.

If you have a KMS subscription for all entries in the Business Register, you will receive the "Nieuwe Inschrijving" and "Gewijzigde Inschrijving" signals. 

• Check the KVK Mutation Service agreement on page 5 to see if both signals are selected. 
• When a new entry is registered, we deliver the "Nieuwe Inschrijving" and "Gewijzigde Inschrijving" signals. 
• When a new KVK number is registered, you will receive both signals. 
• When you make a change to the KVK number (the entry), only the "Gewijzigde Inschrijving" signal is delivered.

View an overview of the available KMS signals.

With selection criterion "SBI-code", you can select the data below as the population. 

Signals related to 

• Registration with secondary establishments. 
• Registration without secondary establishments.

Signal types

View a current overview of the signal types. 

For SBI codes 

• Main activity only. 
• Main activities and/or Secondary activities. 

Combination of selection criteria 

• Postal code combined with SBI code and legal structure. 
• SBI code and legal structure.
• Municipality combined with SBI code and legal structure.

After a mutation or change has taken place in the Business Register, you will receive a notification within 15 minutes.

The date you join is the start date. The annual contract begins on that date. Do you wish to renew? Then you will receive the next invoice on the same date in the following year.

Saving up from previous years or carrying over to subsequent years is not possible.

• Generic information: all current branches of the KVK registration. 
• Specific information: provides an indication of what has changed in the relevant KVK registration. 

View the KVK Mutatieservice catalogue for more examples.

The KVK Mutatieservice catalogue indicates which information (generic and specific) is delivered in a signal.

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 "Vestigingen" and "Deponeringen" data blocks will not show any fields if no change has occurred. The "Onderneming", "Eigenaar", and "Functionarissen" 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 data item. After receiving this notification, you can decide to retrieve the updated data via the KVK API or the KVK Dataservice.

We provide real-time updates on changes to the public data in the Business Register. The exception to this is the Communication Data collection, because the phone and fax numbers are not public. Nor do we provide the email address or website in the signal message.