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.

  • We have a Swagger widget that allows you to test the APIs. More information can be found on the KVK Developer Portal.

  • 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

  • Because the old APIs Handelsregister Search and Profile work differently from the new APIs, we have prepared a schema that details how the new APIs function.

    You use the API KVK Handelsregister Zoeken to find businesses, for example by name or location. Each search result has a built-in hypermedia link to the API KVK Handelsregister Basisprofiel (in which queries require a KVK number) and/or the API KVK Handelsregister Vestigingsprofiel (in which queries require a branch number) for requesting additional information. This is known as HATEAOS in REST.

    Example use of new APIs

  • As of 1 April 2022, these APIs will cease to exist:

    • KVK Handelsregister Search
    • KVK Handelsregister Profile

    These are the new APIs that take their place:

    • KVK Handelsregister Zoeken – search by KVK number, street, place name, or indication main office / branch office.
    • KVK Handelsregister Basisprofiel – request general company data, based on a KVK number.
    • KVK Handelsregister Vestigingsprofiel – request specific company data per office, based on the branch number.
  • The API KVK Handelsregister Search allowed you to search and request basic data. The API KVK Handelsregister Zoeken can only search. Use the new APIs KVK Handelsregister Basisprofiel or Vestigingsprofiel to get information.

    For reasons of privacy, you can no longer search by postal code and/or house number, or to do an all fields free search.

    More about the differences between the APIs Zoeken and Search

  • The API KVK Handelsregister Profile allowed you to request extensive business details. You can still do so using the API KVK Handelsregister Vestigingsprofiel. The API KVK Handelsregister Basisprofiel provides basic data.

    More about the differences between the APIs Basisprofiel, Vestigingsprofiel and Profile

  • From mid-2022, it will be possible to search by postal code and house number again. These are all the search options in the KVK Handelsregister Zoeken:

    • KVK number
    • RSIN
    • Branch number
    • Name
    • Street and city
    • Postal code and house number (new)

    Postal code and house number are not displayed in the standard search results, unless they are the search parameters.

  • Searching will work a bit differently from what you are used to. First, you look up a business with the KVK API Handelsregister Zoeken. Then, you get the information from the other two APIs. The API KVK Handelsregister Basisprofiel uses the KVK number that was found. The API KVK Handelsregister Vestigingsprofiel works with the found branch number.

  • As a rule, only active registrations are displayed. Do you also want to view inactive registrations? Use the parameter 'inclusiefinactieveregistraties'. The search results will include the information whether a branch or legal entity is active or inactive.

    You cannot get information for a branch or legal entity that is inactive and has been deregistered since before 22 May 2010.

  • The costs have partly remained the same.

    • KVK Handelsregister Zoeken is free of charge (API KVK Handelsregister Search cost € 0.008 per query).
    • If you use KVK Handelsregister Basisprofiel or Vestigingsprofiel, you pay € 0.016 per query (the same as API KVK Handelsregister Profile).

    Want to know more about the tariffs? Check the product pages on the Developer Portal.

  • No, these APIs will be phased out. You can use them until 31 March 2022. New clients will not be connected to these.

Is your question not listed?

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

Contact