BusinessThis service is deprecated, and has been replaced by the KvK service. While this service will remain available until the Dutch Chamber of Commerce ends its use of the ‘sub dossier number’ at the end of 2013, we recommend migrating to the new KvK service as soon as possible. See Business::Migration to the KvK service for information on the changes you need to implement. Summary | This service is deprecated, and has been replaced by the KvK service. | | If you currenty use the Business service, this section will help you determine what changes you need to make in order to implement the new service. | | | | For most methods that were not already deprecated there is an equivalent in the KvK service. | | The new KvK service uses a different naming convention for method output elements. | | Migrating to the update service methods of the new KvK service is very easy. | | These methods can be used to retrieve KvK dossiers based on dossier number. | | Look up a BusinessDossierV3 for a business currently registered at the Chamber of Commerce. | | | | Retrieve the establishment number (Dutch ‘Vestigingsnummer’) for a business. | | These methods can be used to find businesses currently registered at the Chamber of Commerce. | | Look up a business using its dossier and subdossier numbers. | | Look up a business using its postcode address. | | Look up a business using its address. | | Look up a business using its name. | | Look up a business by a number of parameters. | | Search for a business by any of the given parameters. | | Search for businesses matching all of the given criteria. | | Search for businesses matching all of the given criteria. | | | | Look up a BIK (‘Bedrijfsindeling kamers van koophandel’) code, which is the type of code returned in a BusinessDossier as the Primary or Secondary activity code. | | Look up a SBI (‘Standaard Bedrijfs Indeling 2008’) code and returns the section and its description, and all levels of SBI codes and their description. | | Converts BIK (‘Bedrijfs Indeling KvK’) to SBI (‘Standaard Bedrijfs Indeling’). | | Converts SBI (‘Standaard Bedrijfs Indeling’) to BIK (‘Bedrijfs Indeling KvK’). | | Returns the SBI (‘Standaard Bedrijfs Indeling 2008’) codes and their descriptions for a dossier. | | Check when dossiers have changed, in order to keep them up to date. | | Retrieve information on the last change of a specific dossier. | | Retrieve dossier numbers for all dossiers changed since the given date. | | The business update service methods allow you to keep KvK data up to date at all times. | | Returns a list of all dossiers that have been updated since they were last retrieved by the user (the user whose credentials are used to make the call). | | Add a dossier to the list of dossiers for which the user (the user whose credentials are used to make the call) wants to receive updates. | | Remove a dossier from the list of dossiers for which the user (the user whose credentials are used to make the call) wants to receive updates. | | An ‘Update type’ is a classification used to indicate which aspect of a dossier has changed. | | | | | | | | | | | | A reference to a single Kvk (Kamer van Koophandel) Dossier entity. | | A reference to a single Kvk (Kamer van Koophandel) Dossier entity. | | A reference to a single Kvk (Kamer van Koophandel) Dossier entity. | | | | A single Kvk (Kamer van Koophandel) Dossier entity. | | A single Kvk (Kamer van Koophandel) Dossier entity. | | Both basic and extended information for a business. | | Extended information on a single Kvk (Kamer van Koophandel) Dossier entity. | | | | SBI activity code information related to a dossier. | | A BIK section code with description. | | A SBI section code with description. | | A BIK (‘Bedrijfsindeling kamers van koophandel’) code with description | | A SBI (‘Standaard Bedrijfs Indeling’) code with description | | | | | | Information about the latest updates to a business. |
Migration to the KvK serviceIf you currenty use the Business service, this section will help you determine what changes you need to make in order to implement the new service. BackgroundIn June 2011 the Chamber of Commerce changed the way organisations are registered to meet the requirements of a new law (http://www.kvk.nl- /over-de-kvk- /over-het-handelsregister- /handelsregisterwet- /). A new, unique, 12 digit establishment number (Dutch: `Vestigingsnummer`) is assigned to every establishment of a business. This number replaces the current sub dossier number, and is not related to the 8 digit business dossier number (`KvK nummer`). In addition, the RSIN number (Dutch: `Rechtspersonen en Samenwerkingsverbanden Informatienummer`) is added to identify the business owner(s)/holder(s). Mapping the Business to the KvK serviceFor most methods that were not already deprecated there is an equivalent in the KvK service. The main difference between the two services is that the new service uses the establishment number, instead of the sub dossier number, to identify business establishments. Organisations that have no establishments, such as foundations, are identified only by their 8 digit dossier number. The main establishment of a business is always assumed when a dossier number is supplied without an establishment number. To look up the new establishment number for businesses already in your systems, you can use businessGetEstablishmentNumber. The following list explains what the equivalent of each Business service method is in the KvK service. Business method equivalentsObsolete business methods| businessGetBIKDescription | BIK codes have been replaced by SBI codes in june 2009 | | businessBIKToSBI | BIK codes have been replaced by SBI codes in june 2009 | | businessSBIToBIK | BIK codes have been replaced by SBI codes in june 2009 | | businessGetSBIDescription | SBI information is already returned by KvK::kvkGetDossier | | businessGetDossierSBI | SBI information is already returned by KvK::kvkGetDossier |
Changes to output elementsThe new KvK service uses a different naming convention for method output elements. All changes to output fields are listed below. Renamed fields| AuthorizedShareCapital | authorized_share_capital | | AuthorizedShareCapitalCurrency | authorized_share_capital_currency | | ChamberNo | chamber_number | | ClassPersonnel | class_personnel | | ContactGender | contact_gender | | ContactInitials | contact_initials | | ContactPrefix | contact_prefix | | ContactSurname | contact_surname | | ContactTitle1 | contact_title1 | | ContactTitle2 | contact_title2 | | ContinuationDate | continuation_date | | CorrespondenceCity | correspondence_city | | CorrespondenceHouseNo | correspondence_house_number | | CorrespondenceHouseNoAddition | correspondence_house_number_addition | | CorrespondencePostcode | correspondence_postcode | | CorrespondenceStreetname | correspondence_street | | DateLastUpdate | date_last_update | | Domainname | domain_name | | DossierNo | dossier_number | | EstablishmentCity | establishment_city | | EstablishmentDate | establishment_date | | EstablishmentHouseNo | establishment_house_number | | EstablishmentHouseNoAddition | establishment_house_number_addition | | EstablishmentPostcode | establishment_postcode | | EstablishmentStreetname | establishment_street | | ExportIndication | indication_export | | FoundingDate | founding_date | | ImportIndication | indication_import | | IndicationBankruptcy | indication_bankruptcy | | IndicationDIP | indication_dip | | IndicationEconomicallyActive | indication_economically_active | | IndicationNonMailing | indication_non_mailing | | IndicationOrganisationcode | indication_organisation_code | | IssuedShareCapital | issued_share_capital | | IssuedShareCapitalCurrency | issued_share_capital_currency | | Legalformcode | legal_form_code | | LegalformcodeText | legal_form_text | | MainBranchIndication | indication_main_establishment | | PaidUpShareCapital | paid_up_share_capital | | PaidUpShareCapitalCurrency | paid_up_share_capital_currency | | Personnel | personnel | | PrimarySBICode | primary_sbi_code | | PrimarySBICodeText | primary_sbi_code_text | | SecondarySBICode1 | secondary_sbi_code1 | | SecondarySBICode1Text | secondary_sbi_code1_text | | SecondarySBICode2 | secondary_sbi_code2 | | SecondarySBICode2Text | secondary_sbi_code2_text | | TelephoneNo | telephone_number | | Tradename45 | trade_name_45 | | TradenameFull | trade_name_full | | UpdateTypes | update_types |
New output fields| establishment_number | the new number for establishments, 12 digits (Dutch: ‘vestigingsnummer’) | | legal_name | the legal name for the business | | main_establishment_number | the establishment number for the main establishment (Dutch: ‘hoofdvestigings nummer’) | | mobile_number | the mobilephone number | | rsin_number | the new rsin number, 9 digits (Dutch: ‘rechtspersonen samenwerkingsverbanden informatie nummer’) | | trade_names | alternative trade names for a business | | update_info | an element containing information on the last update to a business |
Removed fields| MainBranchDossierNo | was always the same as DossierNo therefore removed | | MainBranchSubDossierNo | any reference to the subdossier numbers is deprecated | | PreviousDossierNo | was not used in update service | | PreviousSubDossierNo | any reference to the subdossier numbers is deprecated | | RegisterLetter | is always ‘H’ therefore non informative and removed | | SubDossierNo | any reference to the subdossier numbers is deprecated | | Tradename30 | did not improve functionality, the trade_name_full and trade_name_45 contain enough data | | Tradename1x30 | did not improve functionality, the trade_name_full and trade_name_45 contain enough data | | Tradename2x30 | did not improve functionality, the trade_name_full and trade_name_45 contain enough data |
Update service migrationMigrating to the update service methods of the new KvK service is very easy. All dossiers retrieved and logged using the Business service in the past are also already logged for the KvK service. First add the establishment number to all the dossiers you already have in your own database, via businessGetEstablishmentNumber. Now you can switch to the KvK service equivalents of the update service methods you currently call. Dossier methodsThese methods can be used to retrieve KvK dossiers based on dossier number. You can use one of the business search methods (e.g., businessSearchParametersV3) to find these dossier numbers. Only currently registered businesses are available through the dossier methods. businessGetDossierV3Look up a BusinessDossierV3 for a business currently registered at the Chamber of Commerce. The subdossierno parameter can be left empty to get all Sub Dossiers of one Dossier. SBI codesThis method replaces businessGetDossierV2 in order to provide SBI activity code information, which replaces the BIK codes used by the KvK in the past. If you have currently implemented businessGetDossierV2 you should implement businessGetDossierV3 instead, in order to receive the new SBI codes. Only minor changes are required when making this switch since both methods are very similar. The documentation on BusinessDossierV3 lists all fields that have changed. Besides these field changes both methods are identical. Update serviceIf both dossierno and subdossierno are specified and a matching dossier is found, the requested dossier is logged for the user, so that updates to the dossier can be requested in the future. This only happens if logging of data is enabled for the user, see Business update service methods. Parameters| dossierno | KvK Dossier number | | subdossierno | KvK Sub Dossier number, optional | | page | Page to retrieve, pages start counting at 1 |
ReturnsSee alsoBusiness update service methods, businessGetDossierExtended businessGetDossierExtendedLook up a BusinessDossierExtended for a business currently registered at the Chamber of Commerce. Update serviceIf both dossierno and subdossierno are specified and a matching dossier is found, the requested dossier is logged for the user, so that updates to the dossier can be requested in the future. This only happens if logging of data is enabled for the user, see Business update service methods. Parameters| dossierno | KvK Dossier number, 8 numbers | | subdossierno | KvK Sub Dossier number, 4 numbers |
ReturnsSee alsobusinessGetDossierV3 businessGetEstablishmentNumberRetrieve the establishment number (Dutch ‘Vestigingsnummer’) for a business. Parameters| dossierno | KvK dossier number | | subdossierno | KvK sub dossier number |
ReturnsThe establishment number. May be empty, some organisations may not have establishments. See alsoBusiness::Migration to the KvK service, KvK Business search methodsThese methods can be used to find businesses currently registered at the Chamber of Commerce. Use one of the search methods (e.g., businessSearchName) to get a list of matches. Every match result contains the dossier and sub dossier number needed to retrieve a complete KvK dossier via the businessGetDossierV3 method. businessSearchDossierNumberLook up a business using its dossier and subdossier numbers. dossierno is required, other parameters may be left empty. If the parameter subdossierno is not supplied, all subdossiers for the given dossier number will be returned. If the dossier number does not exist, an empty array is returned. Parameters| dossierno | Dossier number. Eight numbers, required. | | subdossierno | Subdossier number, Four numbers, optional. | | page | Page to retrieve, pages start counting at 1 |
ReturnsbusinessSearchPostcodeLook up a business using its postcode address. nbcode is required, other parameters may be left empty. Parameters| nbcode | 4 number part of a postcode | | lettercomb | 2 letter part of a postcode | | houseno | House number of the addres | | housenoaddition | Addition to a house number, ie R (‘red’), B (‘black’) | | page | Page to retrieve, pages start counting at 1 |
ReturnsSee alsobusinessSearchParametersV3 businessSearchAddressLook up a business using its address. Specified parameters are compared against both establishment and correspondence addresses to find a match. Parameters may be left empty. Parameters| streetname | Name of the street | | houseno | House number of the address | | housenoaddition | Addition to a house number, ie R (‘red’), B (‘black’) | | cityname | Name of the city | | page | Page to retrieve, pages start counting at 1 |
ReturnsSee alsobusinessSearchParametersV3 businessSearchNameLook up a business using its name. Parameters| tradename | Name under which the business engages in commercial activity. When enclosing (part of) a search phrase in double quotes (“phrase”) only matches containing that exact phrase will looked for, which may be helpful if a previous search without quotes returned too many results. | | page | Page to retrieve, pages start counting at 1 |
ReturnsbusinessSearchParametersLook up a business by a number of parameters. At least a tradename, neighborhood code, street, city or telephone number is required. Lookups based on postbus address are possible by specifying streetname ‘Postbus’ and specifying the postbus number in the houseno parameter. Specified address parameters are compared against both establishment and correspondence addresses to find a match. This method differs from businessSearchParametersV3 by returning only businesses which exactly match all the input parameters. businessSearchParametersV3 is more fault tolerant and may include results which don’t match all input parameters since it uses a fuzzy search. Parameters| tradename | Name under which the business engages in commercial activity. When enclosing (part of) a search phrase in double quotes (“phrase”) only matches containing that exact phrase will looked for, which may be helpful if a previous search without quotes returned too many results. | | cityname | Name of the city | | streetname | Name of the street | | nbcode | 4 number part of a postcode | | lettercomb | 2 letter part of a postcode | | houseno | House number of the address | | housenoaddition | Addition to a house number. ‘A’ or ‘B’, for example. | | telephoneno | Telephone number. When only searching by telephone number a minimum of 7 digits must be specified. | | page | Page to retrieve, pages start counting at 1 |
ReturnsSee alsobusinessSearchParametersV3 businessSearchParametersV3Search for a business by any of the given parameters. At least one of the parameters is required. Compared to businessSearchParameters, this method generally returns more results. The matching of businesses against a search query is more fuzzy, thus returning results even if the business information does not match exactly all search parameters. For example, searching for “Webservices.nl” in Amsterdam will still return “Webservices.nl” in Haarlem. Results are ordered so that the best matching results are on top. This method differs from businessSearchParametersV2 in that it also returns the economically active indication. Lookups based on postbus address are possible by specifying streetname ‘Postbus’ and specifying the postbus number in the houseno parameter. Specified address parameters are compared against both establishment and correspondence addresses to find a match. Parameters| tradename | Name under which the business engages in commercial activity. | | cityname | Name of the city | | streetname | Name of the street | | postcode | Postcode | | houseno | House number of the address | | housenoaddition | Addition to a house number. ‘A’ or ‘B’, for example. | | telephoneno | Telephone number. When only searching by telephone number a minimum of 7 digits must be specified. | | page | Page to retrieve, pages start counting at 1 |
ReturnsbusinessSearchSelectionSearch for businesses matching all of the given criteria. Either of these criteria can be left empty or 0. In that case, the criterium is not used. At least one of the criteria parameters must be supplied. At most 100 items may be supplied for the array parameters. Parameters| city | Array of cities. Businesses match if they are located in either of these cities, thus if the establishment address is in one of these cities. | | postcode | Array of postcodes or parts of postcodes. Bussinesses match if they are located in either of these postcodes, or their postcode start with any of the given partial postcodes. Thus, if the establishment address matches with one of the given postcodes. For example, the partial postcode “10” matches most of Amsterdam. Note that it would make little sense to supply both city and postcode. | | sbi | Array of SBI codes or partial SBI codes. Businesses match if they have either of the given SBI codes, or their SBI code starts with the partial SBI code. The CBS has a list of SBI codes and their descriptions. | | primary_sbi_only | Match primary SBI only. A business may have up to three SBI codes assigned. If primary_sbi_only is true, businesses only match if their main SBI code matches with one of the codes in the ‘sbi’ field. If primary_sbi_only is false, businesses are matched if either of the three SBI codes match the ‘sbi’ field. | | legal_forms | Array of integer legal form codes. Bussiness match if they have either of these legalforms. A list of legal form codes can be found in the documentation of BusinessDossierV3. | | employees_min | Minumum number of employees working at the business. | | employees_max | Maximum number of employees working at the business. | | economically_active | Indicates whether the businesses should be economically active.| active | Only economically active businesses match. | | inactive | Only economically inactive businesses match. |
| | financial_status | Indicates the financial status of the businesses.| bankrupt | Only bankrupt businesses match. | | dip | Only businesses which are debtor in possession match. | | solvent | Only businesses which are neither bankrupt nor debtor in possession match. | | insolvent | Only businesses which are either bankrupt or debtor in posession match. |
| | changed_since | Date in yyyy-mm-dd format. Businesses match if the information about them changed after this date. | | page | Page to retrieve, pages start counting at 1 |
ReturnsbusinessSearchSelectionV2Search for businesses matching all of the given criteria. Either of these criteria can be left empty or 0. In that case, the criterium is not used. At least one of the criteria parameters must be supplied. At most 100 items may be supplied for the array parameters. Parameters| city | Array of cities. Businesses match if they are located in either of these cities, thus if the establishment address is in one of these cities. | | postcode | Array of postcodes or parts of postcodes. Bussinesses match if they are located in either of these postcodes, or their postcode start with any of the given partial postcodes. Thus, if the establishment address matches with one of the given postcodes. For example, the partial postcode “10” matches most of Amsterdam. Note that it would make little sense to supply both city and postcode. | | sbi | Array of SBI codes or partial SBI codes. Businesses match if they have either of the given SBI codes, or their SBI code starts with the partial SBI code. The CBS has a list of SBI codes and their descriptions. | | primary_sbi_only | Match primary SBI only. A business may have up to three SBI codes assigned. If primary_sbi_only is true, businesses only match if their main SBI code matches with one of the codes in the ‘sbi’ field. If primary_sbi_only is false, businesses are matched if either of the three SBI codes match the ‘sbi’ field. | | legal_forms | Array of integer legal form codes. Bussiness match if they have either of these legalforms. A list of legal form codes can be found in the documentation of BusinessDossierV3. | | employees_min | Minumum number of employees working at the business. | | employees_max | Maximum number of employees working at the business. | | economically_active | Indicates whether the businesses should be economically active.| active | Only economically active businesses match. | | inactive | Only economically inactive businesses match. |
| | financial_status | Indicates the financial status of the businesses.| bankrupt | Only bankrupt businesses match. | | dip | Only businesses which are debtor in possession match. | | solvent | Only businesses which are neither bankrupt nor debtor in possession match. | | insolvent | Only businesses which are either bankrupt or debtor in posession match. |
| | changed_since | Date in yyyy-mm-dd format. Businesses match if the information about them changed on or after this date. | | new_since | Date in yyyy-mm-dd format. Only businesses which were added on or after this date are returned. Note that this does not mean that the company was founded after this date. Companies may be founded and only later be added to the KvK database. | | page | Page to retrieve, pages start counting at 1 |
ReturnsbusinessGetBIKDescriptionLook up a BIK (‘Bedrijfsindeling kamers van koophandel’) code, which is the type of code returned in a BusinessDossier as the Primary or Secondary activity code. The description for all levels of the BIK code is returned, even if the full length BIK code does not exist. Descriptions of the section associated with the BIK code is also returned. Important: BIK codes have been deprecated in favor of SBI codes. ParametersReturnsbusinessGetSBIDescriptionLook up a SBI (‘Standaard Bedrijfs Indeling 2008’) code and returns the section and its description, and all levels of SBI codes and their description. SBI codes have replaced BIK codes as of June 2009. The description for all levels of the SBI code is returned, even if the full length SBI code does not exist. The codes and descriptions are returned ordered from generic to specific. For example, for the input 011301, the first code and description are 01, Landbouw, jacht en dienstverlening voor de landbouw en jacht
and the last are 011301, Teelt van groenten en champignons
Full SBI codes, which are assigned to businesses, are between four and six characters in length. However, because SBI codes can be grouped on their first 2 numbers, this function accepts input and returns output between 2 and 6 characters in length. The decription for SBI code 23, for example, is applicable to all companies whose SBI code starts with 23. Some SBI codes (e.g. 5630, 6491) have descriptions with non-ASCII characters. Parameters| sbicode | A SBI code, a number between 2 and 6 characters. |
ReturnsbusinessBIKToSBIConverts BIK (‘Bedrijfs Indeling KvK’) to SBI (‘Standaard Bedrijfs Indeling’). For a given BIK code, returns all corresponding SBI codes and their descriptions, and the SBI sections and their descriptions. This function may return multiple SBI codes, because a BIK code may have multiple corresponding SBI codes. In that case, the BIK code is more generic than the SBI equivalents. Often, the returned SBI codes have their first two numbers in common, but this is not the case for BIK code 2330, for example. ParametersReturnsbusinessSBIToBIKConverts SBI (‘Standaard Bedrijfs Indeling’) to BIK (‘Bedrijfs Indeling KvK’). For a given SBI code, returns all corresponding BIK codes and their descriptions, and the BIK sections and their descriptions. This function may return multiple BIK codes, because a SBI code may have multiple corresponding BIK codes. In that case, the SBI code is more generic than the BIK equivalents. Often, the returned BIK codes have the first four numbers of their BIK code in common, but this is not the case for SBI code 6512, for example. ParametersReturnsbusinessGetDossierSBIReturns the SBI (‘Standaard Bedrijfs Indeling 2008’) codes and their descriptions for a dossier. If the given dossier does not exist, an error is returned. Parameters| dossierno | A dossier number. Eight numbers, required. | | subdossierno | A subdossier number. Four numbers, required. |
ReturnsRetrieve updated dossiersCheck when dossiers have changed, in order to keep them up to date. These methods return information on the last change on a dossier, so that the user can check whether the stored dossiers are still up to date. Unlike the business update service methods, the data log does not have to be enabled to use these functions. These methods can be used even if no dossier numbers are logged. businessUpdateCheckDossierRetrieve information on the last change of a specific dossier. This method can be used to check for updates on specific dossiers, regardless of whether requested dossiers are logged for the user. A BusinessUpdateReference is returned for the most recent update, if any. The BusinessUpdateReference contains the date of the latest update to the dossier, as well as the types of updates performed on that date. A fault message is returned if there have never been updates to the dossier. The same fault is returned if the dossier does not exist (or never existed). Parameters| dossierno | KvK Dossier number | | subdossierno | KvK Sub Dossier number | | update_types | The types of updates to consider. See Business::Update types for a list of types. If the type ‘Test’ is specified, a BusinessUpdateReference is returned with DateLastUpdate set to today, its UpdateTypes will contain all the types specified in the request. |
Returns| out | A BusinessUpdateReference describing when the dossier was last updated and what types of updates occurred on that date. |
businessUpdateGetChangedDossiersRetrieve dossier numbers for all dossiers changed since the given date. This method returns a Patterns::{Type}PagedResult of BusinessUpdateReference entries, for all dossiers which were updated since the given changed_since date, and where the update was one of the given update_types. This method can be called periodically to obtain a list of recently updated dossiers. This list can then be checked against the list of locally stored dossiers, to determine which dossiers that the user has stored are changed and may be updated. Parameters| changed_since | Date in YYYY-MM-DD format. All dossiers changed on or after this date are returned. This date may not be more than 40 days ago. | | update_types | The types of updates to consider. See Business::Update types for a list of types. This method supports the update type ‘New’ to retrieve dossiers which have been registered with the KvK since the changed_since date. | | page | Page to retrieve, pages start counting at 1 |
ReturnsSee alsobusinessUpdateCheckDossier Business update service methodsThe business update service methods allow you to keep KvK data up to date at all times. Updates for any dossier requested via our services can be retrieved. In order to provide precisely those updates that are relevant, a list of requested dossiers is kept for every user (this is not enabled by default, contact us to have this enabled). Based on this list we can provide the user with the updates that are needed. Please note that because dossiers are logged per user, a user will only receive updates for dossiers he requested himself, other users in the same account have a separate lists of dossiers for updates. An example- 14-01: User requests dossier ‘1234578 0000’
- 22-02: Webservices.nl processes an update for dossier ‘1234578 0000’
- 24-02: User requests updates. A list of updated dossiers is returned, containing dossier ‘1234578 0000’. The user requests the dossier again and is completely up to date now.
Processing updatesPeriodically (for example, once a day) make a call to the businessUpdateGetDossiers method. It returns a list of dossiers that have been updated since they were last requested. All the listed dossiers can then be updated to the latest version by a call to businessGetDossierV3. After updating, another call to businessUpdateGetDossiers won’t return the same dossiers anymore. If the latest change to a dossier is the removal of the business from the Chamber of Commerce (update type ‘Removed’), then businessUpdateRemoveDossier should be called instead of businessGetDossierV3. Removing dossiersThe businessUpdateGetDossiers method returns a list of available updates for all dossiers requested in the past. If updates to a certain dossier are no longer wanted the businessUpdateRemoveDossier method can be called to prevent receiving updates for the dossier in the future. Adding dossiersA call to businessGetDossierV3 automatically logs the requested dossier for future updates. However, in case you have an existing database with KvK dossiers you may want to signal that you are interested in updates for those dossiers. Using businessUpdateAddDossier you can add a dossier to your list for updates. All future updates to the specified dossier will be returned by businessUpdateGetDossiers. Before adding a dossier to your list you should check if your dossier is up to date. See the section below on how to make sure you currently have the lastest version. businessUpdateGetDossiersReturns a list of all dossiers that have been updated since they were last retrieved by the user (the user whose credentials are used to make the call). If a dossier is returned that is no longer of interest or has the update type ‘Removed’, calling businessUpdateRemoveDossier prevents it from occurring in this methods output. If a dossier from the output list is retrieved using businessGetDossierV3, a second call to businessUpdateGetDossiers will not contain the dossier anymore. Parameters| update_types | A list specifying the types of updates that should be returned. See Business::Update types for a list of types. If the type ‘Test’ is specified, an example BusinessUpdateReference is returned with DateLastUpdate set to today, its UpdateTypes will contain all the types specified in the request. | | page | The page of results |
ReturnsbusinessUpdateAddDossierAdd a dossier to the list of dossiers for which the user (the user whose credentials are used to make the call) wants to receive updates. After adding the dossier any future updates to the dossier can be retrieved using businessUpdateGetDossiers. Before adding the dossier, call businessUpdateCheckDossier to make sure you have the latest dossier version. You do not need to call this method if you have retrieved a dossier using businessGetDossierV3, in which case it has been added automatically. Parameters| dossierno | KvK Dossier number | | subdossierno | KvK Sub Dossier number |
ReturnsNothing businessUpdateRemoveDossierRemove a dossier from the list of dossiers for which the user (the user whose credentials are used to make the call) wants to receive updates. Parameters| dossierno | KvK Dossier number | | subdossierno | KvK Sub Dossier number |
ReturnsNothing Update typesAn ‘Update type’ is a classification used to indicate which aspect of a dossier has changed. Most types correspond to changes in one or more fields of a dossier. See BusinessDossierV3 for an explanation of the fields that are referenced here. | ChamberNo | ChamberNo | | Legalform | Legalformcode, IndicationOrganisationcode | | Name | TradenameFull, Tradename45, Tradename1x30, Tradename2x30, Tradename30, LegalName | | EstablishmentAddress | EstablishmentStreetname, EstablishmentHouseNo, EstablishmentHouseNoAddition, EstablishmentPostcode, EstablishmentCity | | CorrespondenceAddress | CorrespondenceStreetname, CorrespondenceHouseNo, CorrespondenceHouseNoAddition, CorrespondencePostcode, CorrespondenceCity | | Contact | TelephoneNo, Domainname | | Activity | PrimarySBICode, SecondarySBICode1, SecondarySBICode2 | | Personnel | PersonnelFulltime, ClassPersonnelFulltime | | FinancialStatus | IndicationBankruptcy or IndicationDIP has changed. | | Status | IndicationEconomicallyActive, IndicationNonMailing | | Branch | MainBranchIndication, MainBranchDossierNo, MainBranchSubDossierNo | | ImportExport | ImportIndication, ExportIndication | | ContactPerson | ContactTitle1, ContactTitle2, ContactInitials, ContactPrefix, ContactSurname, ContactGender | | Capital | AuthorizedShareCapital, AuthorizedShareCapitalCurrency, PaidUpShareCapital, PaidUpShareCapitalCurrency, IssuedShareCapital, IssuedShareCapitalCurrency | | SubscriptionDates | FoundingDate, ContinuationDate, EstablishmentDate | | Removed | The dossier has been removed | | New | The dossier has been added. Can only be used in the businessUpdateGetChangedDossiers method. |
Deprecated service methodsbusinessSearchParametersV2This method is deprecated, use businessSearchParametersV3 instead. Search for a business by any of the given parameters. At least one of the parameters is required. Compared to businessSearchParameters, this method generally returns more results. The matching of businesses against a search query is more fuzzy, thus returning results even if the business information does not match exactly all search parameters. For example, searching for “Webservices.nl” in Amsterdam will still return “Webservices.nl” in Haarlem. Results are ordered so that the best matching results are on top. Lookups based on postbus address are possible by specifying streetname ‘Postbus’ and specifying the postbus number in the houseno parameter. Specified address parameters are compared against both establishment and correspondence addresses to find a match. Parameters| tradename | Name under which the business engages in commercial activity. | | cityname | Name of the city | | streetname | Name of the street | | postcode | Postcode | | houseno | House number of the address | | housenoaddition | Addition to a house number. ‘A’ or ‘B’, for example. | | telephoneno | Telephone number. When only searching by telephone number a minimum of 7 digits must be specified. | | page | Page to retrieve, pages start counting at 1 |
ReturnsbusinessGetDossierV2This method is deprecated, use businessGetDossierV3 instead. This method returns BusinessDossierV2 dossiers, which include BIK codes that have been replaced by SBI codes since June 2009. Therefor this method has been replaced by businessGetDossierV3. As they are no longer support by the KvK, the BIK fields returned by this method will be empty as of october 2009. See BusinessDossierV2 for a list of the affected fields. Parameters| dossierno | KvK Dossier number | | subdossierno | KvK Sub Dossier number, optional | | page | Page to retrieve, pages start counting at 1 |
ReturnsSee alsobusinessGetDossierV3 businessGetDossierThis method is deprecated, use businessGetDossierV3 instead. Look up a BusinessDossier. The subdossierno parameter can be left empty to get all Sub Dossiers of one Dossier. This method returns BusinessDossier dossiers, which include BIK codes that have been replaced by SBI codes since June 2009. Therefor this method has been replaced by businessGetDossierV3. As they are no longer support by the KvK, the BIK fields returned by this method will be empty as of October 2009. See BusinessDossier for a list of the affected fields. Parameters| dossierno | KvK Dossier number | | subdossierno | KvK Sub Dossier number, optional | | page | Page to retrieve, pages start counting at 1 |
ReturnsSee alsobusinessGetDossierV3 BusinessReferenceA reference to a single Kvk (Kamer van Koophandel) Dossier entity. | DossierNo | The dossier number under which the organisation had registered with the KvK. This dossier number is unique and will not change as long as the organisation exists. Subsidiaries (Dutch: ‘Nevenvestigingen’) of the organisation are registered using the same dossier number. The combination of the Dossier number and sub dossier number is a unique key. | | SubDossierNo | The sub dossier number is used to differentiate between subsidiaries of the same organisation. The combination of the Dossier number and sub dossier number is a unique key. | | Tradename | Name under which the organisation engages in commercial activity | | Streetname | Street name of the organisations establishment or correspondence address, depending on which address matched the parameters. By default the establishment address will be returned. | | City | City of the organisations establishment or correspondence address, depending on which address matched the parameters. By default the establishment city will be returned. For addresses without a postal code in the Dutch format this field will contain the postal code followed by the city. |
BusinessReferenceV2A reference to a single Kvk (Kamer van Koophandel) Dossier entity. | DossierNo | The dossier number under which the organisation had registered with the KvK. This dossier number is unique and will not change as long as the organisation exists. Subsidiaries (Dutch: ‘Nevenvestigingen’) of the organisation are registered using the same dossier number. The combination of the Dossier number and sub dossier number is a unique key. | | SubDossierNo | The sub dossier number is used to differentiate between subsidiaries of the same organisation. The combination of the Dossier number and sub dossier number is a unique key. | | Tradename | Name under which the organisation engages in commercial activity | | EstablishmentStreetname | Street name of the organisations establishment address. | | EstablishmentCity | City of the organisations establishment address. For foreign businesses this field contains both the postcode and city. | | CorrespondenceStreetname | Street name of the organisations correspondence address. | | CorrespondenceCity | City of the organisations correspondence address, For foreign businesses this field contains both the postcode and city. |
BusinessReferenceV3A reference to a single Kvk (Kamer van Koophandel) Dossier entity. | DossierNo | The dossier number under which the organisation had registered with the KvK. This dossier number is unique and will not change as long as the organisation exists. Subsidiaries (Dutch: ‘Nevenvestigingen’) of the organisation are registered using the same dossier number. The combination of the Dossier number and sub dossier number is a unique key. | | SubDossierNo | The sub dossier number is used to differentiate between subsidiaries of the same organisation. The combination of the Dossier number and sub dossier number is a unique key. | | Tradename | Name under which the organisation engages in commercial activity | | EstablishmentStreetname | Street name of the organisations establishment address. | | EstablishmentCity | City of the organisations establishment address. For foreign businesses this field contains both the postcode and city. | | CorrespondenceStreetname | Street name of the organisations correspondence address. | | CorrespondenceCity | City of the organisations correspondence address, For foreign businesses this field contains both the postcode and city. | | IndicationEconomicallyActive | Boolean indicating if the business is economically active. This indication is determined by a formula developed by the ‘Vereninging Kamers van Koophandel’. This should not be interpreted as an indication of whether the business is currently still registered at the Chamber of Commerce: only currently registered businesses are available through our services. |
BusinessDossierThis type has been deprecated, see BusinessDossierV3. BusinessDossierV3 contains an improved selection of address fields. Also, the type of the ClassPersonnelFulltime, IndicationEconomicallyActive, IndicationNonMailing, IndicationBankruptcy and IndicationDIP fields has been changed. WarningSince the KvK no longer supports BIK codes, the following BIK related fields will be empty as of october 2009: PrimaryActivitycode, SecondaryActivitycode1, SecondaryActivitycode2, PrimaryActivitycodeText, SecondaryActivitycode1Text,SecondaryActivitycode2Text BusinessDossierV2A single Kvk (Kamer van Koophandel) Dossier entity. WarningSince the KvK no longer supports BIK codes, the following BIK related fields will be empty as of october 2009: PrimaryActivitycode, SecondaryActivitycode1, SecondaryActivitycode2, PrimaryActivitycodeText, SecondaryActivitycode1Text,SecondaryActivitycode2Text Identification| RegisterLetter | The letter code corresponding to the register the organisation has registered to. Currently only the letter ‘H’ is used. In the past the letters ‘V’ and ‘S’ were also used. | | DossierNo | The dossier number under which the organisation has registered with the KvK. This dossier number is unique and will not change as long as the organisation exists. Subsidiaries (Dutch: ‘Nevenvestigingen’) of the organisation are registered using the same dossier number. The combination of the Dossier number and sub dossier number is a unique key. | | SubDossierNo | The sub dossier number is used to differentiate between subsidiaries of the same organisation. The combination of the Dossier number and sub dossier number is a unique key. | | ChamberNo | The Chamber number is the number of the KvK office which manages this dossier.| 01 | Noord Nederland | | 08 | Oost Nederland | | 09 | Centraal Gelderland | | 14 | Limburg | | 17 | Brabant | | 20 | Zuid West Nederland | | 24 | Rotterdam | | 27 | Den Haag | | 30 | Midden Nederland | | 32 | Gooi-, Eem- en Flevoland | | 34 | Amsterdam | | 37 | Noordwest-Holland |
| | Legalformcode | Registered legal form used by the organisation. | | LegalformcodeText | Description of the legal form (in Dutch). Possible combinations of Legalformcode and LegalformcodeText are:| 01 | Eenmanszaak | | 02 | Eenmanszaak met meer dan één eigenaar | | 03 | NV / BV in oprichting op A-formulier | | 05 | Rederij | | 07 | Maatschap | | 11 | Vennootschap onder firma | | 12 | NV / BV in oprichting op B-formulier | | 21 | Commanditaire Vennootschap met één beherende vennoot | | 22 | Commanditaire Vennootschap met meer dan één beherende vennoot | | 23 | NV / BV in oprichting op D-formulier | | 40 | Rechtspersoon in oprichting | | 41 | Besloten Vennootschap met gewone structuur | | 42 | Besloten Vennootschap blijkens statuten structuurvennootschap | | 51 | Naamloze Vennootschap met gewone structuur | | 52 | Naamloze Vennootschap blijkens statuten structuurvennootschap | | 53 | Naamloze Vennootschap beleggingsmaatschappij met veranderlijk kapitaal | | 54 | NV beleggingsmaatschappij met veranderlijk kapitaal blijkens statuten structuurvennootschap | | 55 | Europese naamloze vennootschap (SE) | | 56 | Europese naamloze vennootschap (SE) blijkens statuten structuurvennootschap | | 61 | Coöperatie U.A. met gewone structuur | | 62 | Coöperatie U.A. blijkens statuten structuurcoöperatie | | 63 | Coöperatie W.A. met gewone structuur | | 64 | Coöperatie W.A. blijkens statuten structuurcoöperatie | | 65 | Coöperatie B.A. met gewone structuur | | 66 | Coöperatie B.A. blijkens statuten structuurcoöperatie | | 70 | Vereniging van Eigenaars | | 71 | Vereniging met volledige rechtsbevoegdheid | | 72 | Vereniging met beperkte rechtsbevoegdheid | | 73 | Kerkgenootschap | | 74 | Stichting | | 81 | Onderlinge waarborgmaatschappij U.A. met gewone structuur | | 82 | Onderlinge waarborgmaatschappij U.A. blijkens statuten structuuronderlinge | | 83 | Onderlinge waarborgmaatschappij W.A. met gewone structuur | | 84 | Onderlinge waarborgmaatschappij W.A. blijkens statuten structuuronderlinge | | 85 | Onderlinge waarborgmaatschappij B.A. met gewone structuur | | 86 | Onderlinge waarborgmaatschappij B.A. blijkens statuten structuuronderlinge | | 88 | Publiekrechtelijke rechtspersoon | | 89 | Privaatrechtelijke rechtspersoon | | 91 | Buitenlandse rechtsvorm met hoofdvestiging in Nederland | | 92 | Nevenvestiging met hoofdvestiging in buitenland | | 93 | Europees Economisch Samenwerkingsverband | | 94 | Buitenlandse EG-vennootschap met onderneming in Nederland | | 95 | Buitenlandse EG-vennootschap met hoofdnederzetting in Nederland | | 96 | Buitenlandse op EG-vennootschap lijkende vennootschap met onderneming in Nederland | | 97 | Buitenlandse op EG-vennootschap lijkende vennootschap met hoofdnederzetting in Nederland |
|
LegacyBefore the introduction of the new commerce register law (Dutch: ‘Nieuwe Handelsregisterwet’) dossier numbers were not assigned for life to an organisation, and could change. The old dossiernumber given below was assigned either before or during the introduction of that law. | PreviousDossierNo | The dossier number under which the organisation was previously registered with the KvK. This dossier number is no longer valid. The combination of the Dossier number and sub dossier number is a unique key. | | PreviousSubDossierNo | The sub dossier number is used to differentiate between subsidiaries of the same organisation. The combination of the Dossier number and sub dossier number is a unique key. |
Name| Tradename30 | Name under which the business engages in commercial activity. Shortened to a maximum of 30 characters. | | Tradename1x30 | Name under which the business engages in commercial activity. First line of a two line name description, maximum of 30 characters long. | | Tradename2x30 | Name under which the business engages in commercial activity. Second line of a two line name description, maximum of 30 characters long. | | Tradename45 | Name under which the business engages in commercial activity. Shortened to a maximum of 45 characters. | | TradenameFull | Name under which the business engages in commercial activity. This is the full name, up to 132 characters long. |
Establishment Address| EstablishmentPostcode | Postcode of the establishment address of the business. A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2. | | EstablishmentCity | City of the establishment address of the business | | EstablishmentStreetname | Streetname of the establishment address of the business | | EstablishmentHouseNo | House number of the establishment address of the business | | EstablishmentHouseNoAddition | House number addition of the establishment address of the business |
Correspondence Address| CorrespondencePostcode | Postcode of the correspondence address of the business. A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2. | | CorrespondenceCity | City of the correspondence address of the business | | CorrespondenceStreetname | Streetname the correspondence address of the business | | CorrespondenceHouseNo | House number of the correspondence address of the business | | CorrespondenceHouseNoAddition | House number addition of the correspondence address of the business |
Contact| TelephoneNo | Telephone number of the establishment. The first five characters contain the area code (Dutch: ‘netnummer’), the last 7 characters the subscriber number (Dutch: ‘abbonnee nummer’). | | Domainname | The internet domain name registered by the business |
BIK activity codesImportant: The activity codes described below are BIK codes. These have been deprecated in favor of SBI codes. See http://www.kvk.nl- /over-de-kvk- /over-het-handelsregister- /wat-staat-er-in-het-handelsregister- /sbi-code- / | PrimaryActivitycode | The primary type of economic or social activity this organisation is associated with. The code corresponds to a BIK code. | | SecondaryActivitycode1 | First of two secondary types of economic or social activity this organisation is associated with. The code corresponds to a BIK code. May be empty. | | SecondaryActivitycode2 | Second of two secondary types of economic or social activity this organisation is associated with. The code corresponds to a BIK code. May be empty. | | PrimaryActivitycodeText | Description of the primary economic or social activity (in Dutch). | | SecondaryActivitycode1Text | Description of the first secondary economic or social activity (in Dutch). | | SecondaryActivitycode2Text | Description of the second secondary economic or social activity (in Dutch). |
Personnel| PersonnelFulltime | The number of employees at the establishment (full-time and part-time combined, contrary to what the field name suggests). | | ClassPersonnelFulltime | A classification of the number of employees at the establishment (full-time and part-time combined, contrary to what the field name suggests). Possible values:| 1 | no employees | | 2 | 1 employee | | 3 | 2 to 4 employees | | 4 | 5 to 9 employees | | 5 | 10 to 19 employee | | 6 | 20 to 49 employees | | 7 | 50 to 99 employees | | 8 | 100 to 199 employees | | 9 | 199 to 499 employees | | 10 | 500 to 749 employees | | 11 | 750 to 999 employees | | 12 | 1000 or more employees |
|
Status| IndicationOrganisationcode | Possible values:| O | Business (Dutch: ‘Onderneming) | | V | Association (Dutch: ‘Vereniging’) | | S | Non-profit organisation (Dutch: ‘Stichting’) | | K | Church community (Dutch: ‘Kerkgenootschap’) | | empty | Unknown |
| | IndicationEconomicallyActive | Boolean indicating if the business is economically active. This indication is determined by a formula developed by the ‘Vereninging Kamers van Koophandel’. This should not be interpreted as an indication of whether the business is currently still registered at the Chamber of Commerce: only currently registered businesses are available through our services. | | IndicationNonMailing | Boolean indicating if the business has specified that the ‘Vereniging Kamers van Koophandel’ and the ‘de kamers van koophandel’ may not supply the business’ information to third parties for direct marketing purposes. | | IndicationBankruptcy | Boolean indicating if the business is currently registered as bankrupt (Dutch: ‘Faillissement’). | | IndicationDIP | Boolean indicating if the business is currently registered as Debtor-in-Possession (Dutch: ‘in Surseance’). |
BusinessDossierV3A single Kvk (Kamer van Koophandel) Dossier entity. | Activity codes | PrimaryActivitycode, SecondaryActivitycode1, SecondaryActivitycode2 are replaced by PrimarySBICode, SecondarySBICode1 and SecondarySBICode2, respectively | | Activity code texts | PrimaryActivitycodeText, SecondaryActivitycode1Text, SecondaryActivitycode2Text are replaced by PrimarySBICodeText, SecondarySBICode1Text and SecondarySBICode2Text, respectively | | Tradename fields | Tradename30, Tradename1x30 and Tradename2x30 are no longer supported | | Personnel fields | PersonnelFulltime and ClassPersonnelFulltime have been replaced by Personnel and ClassPersonnel, respectively |
All fields of the dossier are described below. Identification| RegisterLetter | The letter code corresponding to the register the organisation has registered to. Currently only the letter ‘H’ is used. In the past the letters ‘V’ and ‘S’ were also used. | | DossierNo | The dossier number under which the organisation has registered with the KvK. This dossier number is unique and will not change as long as the organisation exists. Subsidiaries (Dutch: ‘Nevenvestigingen’) of the organisation are registered using the same dossier number. The combination of the Dossier number and sub dossier number is a unique key. | | SubDossierNo | The sub dossier number is used to differentiate between subsidiaries of the same organisation. The combination of the Dossier number and sub dossier number is a unique key. | | ChamberNo | The Chamber number is the number of the KvK office which manages this dossier.| 01 | Noord Nederland | | 08 | Oost Nederland | | 09 | Centraal Gelderland | | 14 | Limburg | | 17 | Brabant | | 20 | Zuid West Nederland | | 24 | Rotterdam | | 27 | Den Haag | | 30 | Midden Nederland | | 32 | Gooi-, Eem- en Flevoland | | 34 | Amsterdam | | 37 | Noordwest-Holland |
| | Legalformcode | Registered legal form used by the organisation. | | LegalformcodeText | Description of the legal form (in Dutch). Possible combinations of Legalformcode and LegalformcodeText are:| 01 | Eenmanszaak | | 02 | Eenmanszaak met meer dan één eigenaar | | 03 | NV / BV in oprichting op A-formulier | | 05 | Rederij | | 07 | Maatschap | | 11 | Vennootschap onder firma | | 12 | NV / BV in oprichting op B-formulier | | 21 | Commanditaire Vennootschap met één beherende vennoot | | 22 | Commanditaire Vennootschap met meer dan één beherende vennoot | | 23 | NV / BV in oprichting op D-formulier | | 40 | Rechtspersoon in oprichting | | 41 | Besloten Vennootschap met gewone structuur | | 42 | Besloten Vennootschap blijkens statuten structuurvennootschap | | 51 | Naamloze Vennootschap met gewone structuur | | 52 | Naamloze Vennootschap blijkens statuten structuurvennootschap | | 53 | Naamloze Vennootschap beleggingsmaatschappij met veranderlijk kapitaal | | 54 | NV beleggingsmaatschappij met veranderlijk kapitaal blijkens statuten structuurvennootschap | | 55 | Europese naamloze vennootschap (SE) | | 56 | Europese naamloze vennootschap (SE) blijkens statuten structuurvennootschap | | 61 | Coöperatie U.A. met gewone structuur | | 62 | Coöperatie U.A. blijkens statuten structuurcoöperatie | | 63 | Coöperatie W.A. met gewone structuur | | 64 | Coöperatie W.A. blijkens statuten structuurcoöperatie | | 65 | Coöperatie B.A. met gewone structuur | | 66 | Coöperatie B.A. blijkens statuten structuurcoöperatie | | 70 | Vereniging van Eigenaars | | 71 | Vereniging met volledige rechtsbevoegdheid | | 72 | Vereniging met beperkte rechtsbevoegdheid | | 73 | Kerkgenootschap | | 74 | Stichting | | 81 | Onderlinge waarborgmaatschappij U.A. met gewone structuur | | 82 | Onderlinge waarborgmaatschappij U.A. blijkens statuten structuuronderlinge | | 83 | Onderlinge waarborgmaatschappij W.A. met gewone structuur | | 84 | Onderlinge waarborgmaatschappij W.A. blijkens statuten structuuronderlinge | | 85 | Onderlinge waarborgmaatschappij B.A. met gewone structuur | | 86 | Onderlinge waarborgmaatschappij B.A. blijkens statuten structuuronderlinge | | 88 | Publiekrechtelijke rechtspersoon | | 89 | Privaatrechtelijke rechtspersoon | | 91 | Buitenlandse rechtsvorm met hoofdvestiging in Nederland | | 92 | Nevenvestiging met hoofdvestiging in buitenland | | 93 | Europees Economisch Samenwerkingsverband | | 94 | Buitenlandse EG-vennootschap met onderneming in Nederland | | 95 | Buitenlandse EG-vennootschap met hoofdnederzetting in Nederland | | 96 | Buitenlandse op EG-vennootschap lijkende vennootschap met onderneming in Nederland | | 97 | Buitenlandse op EG-vennootschap lijkende vennootschap met hoofdnederzetting in Nederland |
|
LegacyBefore the introduction of the new commerce register law (Dutch: ‘Nieuwe Handelsregisterwet’) dossier numbers were not assigned for life to an organisation, and could change. The old dossiernumber given below was assigned either before or during the introduction of that law. | PreviousDossierNo | The dossier number under which the organisation was previously registered with the KvK. This dossier number is no longer valid. The combination of the Dossier number and sub dossier number is a unique key. | | PreviousSubDossierNo | The sub dossier number is used to differentiate between subsidiaries of the same organisation. The combination of the Dossier number and sub dossier number is a unique key. |
Name| Tradename45 | Name under which the business engages in commercial activity. Shortened to a maximum of 45 characters. | | TradenameFull | Name under which the business engages in commercial activity. This is the full name, up to 132 characters long. |
Establishment Address| EstablishmentPostcode | Postcode of the establishment address of the business. A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2. | | EstablishmentCity | City of the establishment address of the business | | EstablishmentStreetname | Streetname of the establishment address of the business | | EstablishmentHouseNo | House number of the establishment address of the business | | EstablishmentHouseNoAddition | House number addition of the establishment address of the business |
Correspondence Address| CorrespondencePostcode | Postcode of the correspondence address of the business. A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2. | | CorrespondenceCity | City of the correspondence address of the business | | CorrespondenceStreetname | Streetname the correspondence address of the business | | CorrespondenceHouseNo | House number of the correspondence address of the business | | CorrespondenceHouseNoAddition | House number addition of the correspondence address of the business |
Contact| TelephoneNo | Telephone number of the establishment. The first five characters contain the area code (Dutch: ‘netnummer’), the last 7 characters the subscriber number (Dutch: ‘abbonnee nummer’). | | Domainname | The internet domain name registered by the business |
SBI activity codes| PrimarySBICode | The primary SBI code describing the type of economic or social activity this organisation is associated with. May be empty. | | SecondarySBICode1 | First of two secondary SBI codes describing the types of economic or social activity this organisation is associated with. May be empty. | | SecondarySBICode2 | Second of two secondary SBI codes describing the types of economic or social activity this organisation is associated with. May be empty. | | PrimarySBICodeText | Description of the primary economic or social activity (in Dutch). | | SecondarySBICode1Text | Description of the first secondary economic or social activity (in Dutch). | | SecondarySBICode2Text | Description of the second secondary economic or social activity (in Dutch). |
Personnel| Personnel | The total number of employees (full-time and part-time) at this establishment. | | ClassPersonnel | A classification of the total number of employees (full-time and part-time). Possible values:| 1 | no employees | | 2 | 1 employee | | 3 | 2 to 4 employees | | 4 | 5 to 9 employees | | 5 | 10 to 19 employee | | 6 | 20 to 49 employees | | 7 | 50 to 99 employees | | 8 | 100 to 199 employees | | 9 | 199 to 499 employees | | 10 | 500 to 749 employees | | 11 | 750 to 999 employees | | 12 | 1000 or more employees |
|
Status| IndicationOrganisationcode | Possible values:| O | Business (Dutch: ‘Onderneming) | | V | Association (Dutch: ‘Vereniging’) | | S | Non-profit organisation (Dutch: ‘Stichting’) | | K | Church community (Dutch: ‘Kerkgenootschap’) | | empty | Unknown |
| | IndicationEconomicallyActive | Boolean indicating if the business is economically active. This indication is determined by a formula developed by the ‘Vereninging Kamers van Koophandel’. This should not be interpreted as an indication of whether the business is currently still registered at the Chamber of Commerce: only currently registered businesses are available through our services. | | IndicationNonMailing | Boolean indicating if the business has specified that the ‘Vereniging Kamers van Koophandel’ and the ‘de kamers van koophandel’ may not supply the business’ information to third parties for direct marketing purposes. | | IndicationBankruptcy | Boolean indicating if the business is currently registered as bankrupt (Dutch: ‘Faillissement’). | | IndicationDIP | Boolean indicating if the business is currently registered as Debtor-in-Possession (Dutch: ‘in Surseance’). |
BusinessDossierExtendedBoth basic and extended information for a business. BusinessDossierExtendedPartExtended information on a single Kvk (Kamer van Koophandel) Dossier entity. | MainBranchIndication | Indication whether this dossier is for a branch or a headoffice. If true, this dossier is for a headoffice. If false, it is for a branch. Optional. | | MainBranchDossierNo | The dossier number for the headoffice. This seldomly differs from the requested dossier number, because branches of the same company often get the same dossier number with a different subdossier number. | | MainBranchSubDossierNo | The subdossier number for the headoffice. This differs from the requested dossier number if this business is a branch instead of a headoffice. | | ImportIndication | Indication of whether the company does import. Optional. | | ExportIndication | Indication of whether the company does export. Optional. | | LegalName | Legal corporation name. Formal name of the business. | | ContactTitle1 | Title of the contact person of this business. | | ContactTitle2 | Second title of the contact person of this business. | | ContactInitials | Initials of the contact. | | ContactPrefix | Name prefix of the contact. | | ContactSurname | Surname of the contact. | | ContactGender | Gender of the contact.| m | Male | | f | Female | | empty | Gender unknown |
| | AuthorizedShareCapital | Number indicating the amount of authorized share capital. The amount of money for which the company is allowed to give out shares. Dutch: “maatschappelijk kapitaal”. Optional. | | AuthorizedShareCapitalCurrency | Currency for AuthorizedShareCapital. Optional. | | PaidUpShareCapital | Number indicating the amount of paid up share capital. The amount of money the share holders paid to the company for their shares. Dutch: “gestort kapitaal”. Optional. | | PaidUpShareCapitalCurrency | Currency for PaidUpShareCapital. Optional. | | IssuedShareCapital | Number indicating the amount of issued share capital. This is the amount for this the company has issued shares. Dutch: “geplaatst kapitaal”. Optional. | | IssuedShareCapitalCurrency | Currency for IssuedShareCapital. Optional. | | FoundingDate | A BusinessDate indicating the founding date of the company. Optional. | | ContinuationDate | A BusinessDate indicating the continuation date of the company, if applicable. This is usually the date that the company changed legal form. Optional. | | EstablishmentDate | A BusinessDate indicating the date of establishment. Date the company started its activities. This date does not change when the company moves to another location. Optional. |
BusinessDateA date. For some dates, the day and month are unknown. In that case, they are left empty. | Year | The year of this date. | | Month | The month of this date, 1 for January. Optional. | | Day | The day of this month. Optional. |
BusinessDossierSBISBI activity code information related to a dossier. | PrimarySBICode | The primary SBI code describing the type of economic or social activity this organisation is associated with. May be empty. | | SecondarySBICode1 | First of two secondary SBI codes describing the types of economic or social activity this organisation is associated with. May be empty. | | SecondarySBICode2 | Second of two secondary SBI codes describing the types of economic or social activity this organisation is associated with. May be empty. | | PrimarySBICodeText | Description of the primary economic or social activity (in Dutch). | | SecondarySBICode1Text | Description of the first secondary economic or social activity (in Dutch). | | SecondarySBICode2Text | Description of the second secondary economic or social activity (in Dutch). |
BusinessBIKSectionA BIK section code with description. BusinessBIKCodes are related to (sub)section codes. | sectioncode | A BIK section code | | description | Description of the BIK code |
BusinessSBISectionA SBI section code with description. BusinessSBICodes are related to section codes. | sectioncode | A SBI section code, a capital letter between A and U. | | description | Description of the SBI section. |
BusinessBIKCodeA BIK (‘Bedrijfsindeling kamers van koophandel’) code with description | bikcode | A BIK code | | description | Description of the BIK code |
BusinessSBICodeA SBI (‘Standaard Bedrijfs Indeling’) code with description | sbicode | A SBI code, a number up to six characters in length. | | description | Description of the SBI code. |
BusinessBIKCodeInfoDescriptions related to a BusinessBIKCode. Important: BIK codes will be deprecated in favor of SBI codes as of june 2009. |