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 Chamber of Commerce number and Vestigingsprofiel only with a location number.

  • 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, see page 8 of our manual (Dutch only).

    NOTE: For testing with your own software, the TLS certificate api.kvk.nl must be accepted by your software. For more information, see our TLS Certificate Manual.

  • In the API manual (pages 10 to 19, Dutch only) you will find a matrix with all 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.

  • No. Keep an eye on the number of inquiries yourself to avoid a high bill.

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

  • The Zoeken API only allows you to look up companies. You get the information with the other two APIs. The API KVK Handelsregister Basisprofiel works with the Chamber of Commerce number found. The API KVK Handelsregister Vestigingsprofiel works with the location number found.

  • 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 API manual (page 20, Dutch only) for this.

  • You pay a monthly fee of € 5.20 per API key for the connection. If you use the KVK Handelsregister Basisprofiel or Vestigingsprofiel, you pay € 0.016 per query. KVK Handelsregister Zoeken is free.

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

  • Yes, when it comes to your own applications, no when it comes to the applications from the Developer Portal.

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

  • Go to the Developer Portal, fill in all the details and request an API key/connection. Do you want to request an extra API key? Then follow the same steps. You will receive a new contract because it is currently not possible to request multiple API keys under the same contract.

  • 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/v1/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.

  • There are public and private certificates. Public certificates are trusted by your software by default. This does not apply to private certificates. As of 1 October 2020, the Dutch government - and therefore also the KVK - will always use private certificates for machine-to-machine communication. This means that you have to 'trust' our TLS certificate in your software.

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

  • Your payment details will only be used for payments for use of the KVK API. Your data will not be shared with third parties and will not be used for other KVK payment processes.

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

  • We will inform you by e-mail. Your registered contact person will receive a service message. Do you also want to receive these updates? Send us a request via our contact form.

  • The average response time is around 500 ms.

  • The Chamber of Commerce (KVK) uses direct debit as payment method for the KVK API or sends an invoice with a payment term.

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

Is your question not listed?

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

Contact