Dutch Business

This service provides Chamber of Commerce business data for Dutch companies.

Summary
This service provides Chamber of Commerce business data for Dutch companies.
Retrieve data on a business establishment.
Retrieve data on a business establishment including information related to finance and structure.
Retrieve data on a business establishment including information related to finance, corporate structure and insolvency.
Retrieve SBI Information for a company.
Get the VatNumber for a specified dossier number
Get the business positions/functionaries for a business
Get the legal entity for a business
Retrieve the organization tree of a company.
Search for business establishments using a known identifier.
Search for an overview of Corporate Group Relationships aka ‘concern relaties’ for specified dossier number.
Get all known details of a Corporate Group Relationships aka ‘concern relaties’ for specified dossier number.
Find business establishments using a variety of parameters.
Find business establishments for a dossier number.
Search for business establishments using a known identifier.
Find business establishments based on postcode and house number.
Search for businesses matching all of the given criteria.
Simple Search for businesses.
Look up a SBI (‘Standaard Bedrijfs Indeling 2008’) code.
Request an annual financial statement document for a dutch-business.
Get an extract document in PDF, containing the available Chamber of Commerce data for a business.
Get the data from an extract document containing the available Chamber of Commerce data for a business.
Get the extract data and document for a business dossier
Get the extract data and document for a business dossier
Get the legal extract data and document for a business dossier
Get the legal extract data and document for a business dossier
Get a list of historical business-extract references for the given company or organisation collected by Webservices.nl.
Get a list of historical business-extract references for the given company or organisation collected by Webservices.nl that contain changes compared to their previous retrieved extract.
Retrieve a historical business-extract using a business-extract identifier.
Retrieve a historical business-extract using a business-extract identifier.
Retrieve a historical business-extract using a business-extract identifier.
Get a list of logged updates for a specific business dossier.
Check when dossiers have changed, in order to keep them up to date.
Returns a list of all companies (that have been added to the users follow list) that have been updated since they were last retrieved by the user (the user whose credentials are used to make the call).
Retrieve information on the last change to a company.
Retrieve dossier numbers for all companies that changed since the given date.
The business update service methods allow you to keep DutchBusiness data up to date at all times.
Add a company to the follow list for which the user (the user whose credentials are used to make the call) wants to receive updates.
Remove a company from the follow list for which the user (the user whose credentials are used to make the call) wants to receive updates.
Get a complete overview of all the companies that are on the follow list for the user (the user whose credentials are used to make the call).
The business update service methods allow you to keep DutchBusiness data up to date at all times.
The news service provides endpoints with which news items related to businesses can be queried.
Returns news-items for a given company based on dossier number.
Starts a UBO investigation.
Checks the status of an (ongoing) UBO investigation.
Pick up the results of the UBO investigation.
Returns a receipt with specification of costs made for a successfully completed UBO investigation.
Classifies natural persons found in a DutchBusinessUBOClassificationResult and tries to resolve the real UBO.
Retrieve the Lei code and related information for a business using the Chamber of Commerce number.
This function is deprecated use dutchBusinessSearchParametersV2 instead.
Information on a business establishment.
Information about the Corporate Group Relationships aka ‘concernrelaties’ structure of a single business
Basic information about the Corporate Group Relationships aka ‘concernrelaties’ structure of a Dutch business.
Detailed information about the Corporate Group Relationships aka ‘concernrelaties’ structure of a single business.
A graph containing the concern structure of a business
A node representing a business
A relation between two businesses
Information on a business establishment including information related to finance and structure.
Information on a business establishment including information related to finance and structure.
Summarized information from the last annual financial statement.
Information about the structure of the organization.
An extract document containing the available Chamber of Commerce data for a business.
An extract docdateRement containing the available Chamber of Commerce data for a business.
The legal entity of the requested dossier (`Rechtspersoon`).
A partnership of the requested dossier (`samenwerkingsverband`).
The enterprise (`onderneming`) of the requested dossier.
A establishment (vestiging) of the dossier, dossier can contain more than one establishment.
A business position can contain data about a person or business that holds a position within the business.
The money is given in the smallest available units for the currency (EUR -> cents)
The money is given in the smallest available units for the currency (EUR -> cents)
Descriptions related to a DutchBusinessSBICode.
A SBI section code with description.
A SBI (‘Standaard Bedrijfs Indeling’) code with description
The data of a publication of an event that occurred for the insolvency (fi.
A reference to a business establishment.
A reference to a business establishment.
A reference to a business establishment.
Information on the latest update to a business establishment.
A date.
Information about the extract document base we have gathered.
Information about the changes that have been logged within our system, between the date the extract document is last retrieved and now.
Reference to a stored extract document.
Information about the changes that have been logged within our system, between a stored extract document and a previous one for that dossier.
Updates that have occured related to a business.
Reference to the dossier updates that occurred on a specific update date.
Information about the changes that have been logged within our system for a specific dossier
The period the change set applies to.
A news item.
A company related to a news item.
A UBO investigation token.
A status of a given UBO investigation.
The results of the UBO investigation.
A business reference found during a UBO investigation
A natural person found during a UBO investigation
A person role found during a UBO investigation
An organisation found during a UBO investigation
An extract of a DutchBusinessUBOOrganisation found during a UBO investigation
The costs of the UBO investigation.
Breakdown of the costs for a UBO investigation
Breakdown of costs
Result of a UBO classification.
A classified suspect
The personal information for the classified suspect
The role of the classified suspect
Breakdown of UBO Payment
A DutchBusiness Company SBI Collection.
A DutchBusiness annual financial statement.
The result of a dutchBusinessGetLei request
A DutchBusiness LEI registration.
A DutchBusiness Lei business entity, contains information regarding the business itself.
Legal form information regarding the LEI entity.
Additional registration information provided by the registration authority.
A DutchBusiness Lei address.
A DutchBusiness Lei successor.
An ‘Update type’ is a classification used to indicate which aspect of a dossier has changed.
The DutchBusinessReferenceV2 contains a match_type field which indicates on what name field the result was found within the response.
A UBO investigation can progress through a distinct set of steps, denoted by their status.
The tree of a DutchBusinessUBOInvestigationResult will contain three types of children.
A dutchBusinessUBOClassifyInvestigation classifies the found UBO suspects (Ultimate Beneficiary Owner), according to the rules of the scenario for labelling the found suspects

Dutch Business methods

dutchBusinessGetDossier

Retrieve data on a business establishment.  When only the dossier number parameter is specified, the main establishment of the business will be returned.  Specify the establishment_number in order to retrieve another establishment.

Update service

If logging of data is enabled for the user, the requested dossier is logged.  This enables the user to receive updates to the dossier in the future.  See Dutch Business update service methods.

Parameters

dossier_numberThe Chamber of Commerce number
establishment_numberThe Establishment number

Returns

outA DutchBusinessDossier

See also

dutchBusinessSearch, dutchBusinessSearchParameters, dutchBusinessSearchDossierNumber

dutchBusinessGetDossierV2

Retrieve data on a business establishment including information related to finance and structure.  When only the dossier number parameter is specified the main establishment of the business will be returned.  Specify the establishment_number in order to retrieve another establishment.

You can find dossier and establishment numbers using dutchBusinessSearch, dutchBusinessSearchParameters or dutchBusinessSearchDossierNumber.

Update service

If logging of data is enabled for the user, the requested dossier is logged.  This enables the user to receive updates to the dossier in the future.  See Dutch Business update service methods.

Parameters

dossier_numberThe Chamber of Commerce number
establishment_numberThe Establishment number

Returns

outA DutchBusinessDossierV2

See also

dutchBusinessSearch, dutchBusinessSearchParameters, dutchBusinessSearchDossierNumber

dutchBusinessGetDossierV3

Retrieve data on a business establishment including information related to finance, corporate structure and insolvency.  When only the dossier number parameter is specified the main establishment of the business will be returned.  Specify the establishment_number in order to retrieve another establishment.

You can find dossier and establishment numbers using dutchBusinessSearch, dutchBusinessSearchParameters or dutchBusinessSearchDossierNumber.

Update service

If logging of data is enabled for the user, the requested dossier is logged.  This enables the user to receive updates to the dossier in the future.  See Dutch Business update service methods.

Parameters

dossier_numberThe Chamber of Commerce number
establishment_numberThe Establishment number

Returns

outA DutchBusinessDossierV3

See also

dutchBusinessSearch, dutchBusinessSearchParameters, dutchBusinessSearchDossierNumber

dutchBusinessGetSBI

Retrieve SBI Information for a company.  The Dutch Standaard Bedrijfsindeling (SBI 2008) is an activity classification based on of the European Union.  Next to The Chamber of Commerce provided SBI code, CompanyInfo provides extra more useful codes.

Parameters

dossier_numberthe Chamber of Commerce number
establishment_numberthe Establishment number.  Defaults to main establishment, when empty
languagethe language of the resulted sbi code descriptions.  Defaults to NL, when empty
nlDutch (default)
enEnglish

Returns

outA DutchBusinessSBICollection

dutchBusinessGetVatNumber

Get the VatNumber for a specified dossier number

Parameters

dossier_numberThe Chamber of Commerce number

Returns

outA DutchBusinessVatNumber

dutchBusinessGetPositions

Get the business positions/functionaries for a business

Parameters

dossier_numberThe Chamber of Commerce number

Returns

outA DutchBusinessPositions entry

dutchBusinessGetLegalEntity

Get the legal entity for a business

Parameters

dossier_numberThe Chamber of Commerce number

Returns

outA DutchBusinessLegalEntityData entry

dutchBusinessGetOrganizationTree

Retrieve the organization tree of a company.

Parameters

dossier_numberThe Chamber of Commerce number

Returns

outA DutchBusinessOrganizationTree entry.

dutchBusinessSearchDossierNumber

Search for business establishments using a known identifier.  Any combination of parameters may be specified.  Only businesses matching all parameters will be returned.

Parameters

dossier_numberThe Chamber of Commerce number
establishment_numberThe Establishment number
rsin_numberThe RSIN (`Rechtspersonen Samenwerkingsverbanden Informatie Nummer`) number
pagePage to retrieve, pages start counting at 1

Returns

outA Patterns::{Type}PagedResult of DutchBusinessReference

See also

dutchBusinessGetDossier, dutchBusinessGetDossierV2

dutchBusinessGetConcernRelationsOverview

Search for an overview of Corporate Group Relationships aka ‘concern relaties’ for specified dossier number.  The overview gives a summary of the concern-relations size and depth.

Parameters

dossier_numberThe Chamber of Commerce dossier number

Returns

outA DutchBusinessGetConcernRelationsOverviewResult.

dutchBusinessGetConcernRelationsDetails

Get all known details of a Corporate Group Relationships aka ‘concern relaties’ for specified dossier number.

Parameters

dossier_numberThe Chamber of Commerce dossier number
include_sourceWhen set the original source is added to the response

Returns

outA DutchBusinessGetConcernRelationsDetailsResult.

dutchBusinessSearchParametersV2

Find business establishments using a variety of parameters.  Found dossiers are ordered by relevance, ensuring the dossiers that match the search parameters best are listed at the top of the result list.  This method differs from dutchBusinessSearchParameters by returning an indication called “match_type” that defines what type of business name was matched upon (see Tradename match types).

Using the search parameters

  • trade_name parameter will be used to search all business names for the dossiers, which include the trade name, legal name and alternative trade names.
  • address parameters are matched against both the correspondence and establishment addresses of the business.
  • postbus addresses can be found by specifying ‘Postbus’ as street, and specifying the postbus number in the house_number parameter.

Response ordering

  • better match, the results that match the given search parameters better are ranked higher, making names containing all words from search parameters appear on top of the results
  • unique words, the more unique words that are ranked higher than common ones, this prevent words like “van” or “de” pollute the ordering when they are searched on

Parameters

trade_nameName under which the organisation engages in commercial activity
cityCity
streetStreet
postcodePostcode
house_numberHouse number
house_number_additionHouse number addition
telephone_numberTelephone number
domain_nameDomain name or email address, when an email address is given the domain part of that address is used
strict_searchBoolean indicating if only strict matches should be returned, resulting in less matches.
pagePage to retrieve, pages start counting at 1

Returns

outA Patterns::{Type}PagedResult of DutchBusinessReferenceV2

See also

dutchBusinessSearchDossierNumber, dutchBusinessGetDossier

dutchBusinessSearch

Find business establishments for a dossier number.  Found dossiers are ordered by relevance, ensuring the establishments that match the search parameters best are listed at the top of the result list.  When the dossier_number is omitted, the search behaves similar to the dutchBusinessSearchParametersV2 method.

Using the search parameters

  • trade_name parameter will be used to search all business names for the dossiers, which include the trade name, legal name and alternative trade names.
  • address parameters are matched against both the correspondence and establishment addresses of the business.
  • postbus addresses can be found by specifying ‘Postbus’ as street, and specifying the postbus number in the house_number parameter.

Response ordering

  • better match, the results that match the given search parameters better are ranked higher, making names containing all words from search parameters appear on top of the results
  • unique words, more unique words are ranked higher than common ones.  This prevent words like “van” or “de” pollute the ordering when they’re searched on.

Parameters

dossier_numberDossier number for the business
trade_nameName under which the organisation engages in commercial activity
cityCity
streetStreet
postcodePostcode
house_numberHouse number
house_number_additionHouse number addition
telephone_numberTelephone number
domain_nameDomain name or email address, when an email address is given the domain part of that address is used
strict_searchBoolean indicating if only strict matches should be returned, resulting in less matches.
pagePage to retrieve, pages start counting at 1

Returns

outA Patterns::{Type}PagedResult of DutchBusinessEstablishmentReference

dutchBusinessSearchEstablishments

Search for business establishments using a known identifier.  Any combination of parameters may be specified.  Only businesses matching all parameters will be returned.

Parameters

dossier_numberThe Chamber of Commerce number
establishment_numberThe Establishment number
rsin_numberThe RSIN (`Rechtspersonen Samenwerkingsverbanden Informatie Nummer`) number
pagePage to retrieve, pages start counting at 1

Returns

outA Patterns::{Type}PagedResult of DutchBusinessEstablishmentReference

dutchBusinessSearchPostcode

Find business establishments based on postcode and house number.  This method can return more matches than dutchBusinessSearchParameters.

Parameters

postcodePostcode
house_numberHouse number
house_number_additionHouse number addition
pagePage to retrieve, pages start counting at 1

Returns

outA Patterns::{Type}PagedResult of DutchBusinessReference

See also

dutchBusinessSearchParameters, dutchBusinessSearchDossierNumber, dutchBusinessGetDossier, dutchBusinessGetDossierV2

dutchBusinessSearchSelection

Search 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

cityArray of cities.  Businesses match if they are located in either of these cities, thus if the establishment address is in one of these cities.
postcodeArray of postcodes or parts of postcodes.  Businesses 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.
sbiArray 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_onlyMatch 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_formArray of integer legal form codes.  Businesses match if they have either of these legalforms.  A list of legal form codes can be found in the documentation of DutchBusinessDossierV2.
employees_minMinimum number of employees working at the business.
employees_maxMaximum number of employees working at the business.
economically_activeIndicates whether the businesses should be economically active.
activeOnly economically active businesses match.
inactiveOnly economically inactive businesses match.
financial_statusIndicates the financial status of the businesses.
bankruptOnly bankrupt businesses match.
dipOnly businesses which are debtor in possession match.
solventOnly businesses which are neither bankrupt nor debtor in possession match.
insolventOnly businesses which are either bankrupt or debtor in posession match.
changed_sinceDateTime in yyyy-mm-dd hh:mm:ss format.  Time may be omitted and defaults to 00:00:00.  Businesses match if the information about them changed from this DateTime on.
new_sinceDateTime in yyyy-mm-dd hh:mm:ss format.  Time may be omitted and defaults to 00:00:00.  Only businesses which were added on or after this DateTime 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 DutchBusiness database.
pagePage to retrieve, pages start counting at 1
provincesArray of Dutch province names or codes according to ISO 3166-2:NL.  ISO 3166-2 defines codes for the names of the principal subdivisions.  Example of ISO 3166-2 see ISO-codes
sbi_match_typeDefines where the sbi inputs should be matched against
WSSBI codes are matched against the default SBI source (default)
CISBI codes are matched against the extra Company.info SBI source
ALLSBI codes are matched against all known SBI sources Returns:
outA Patterns::{Type}PagedResult of DutchBusinessReference.

dutchBusinessSearchSelectionSimple

Simple Search for businesses.  Similar to dutchBusinessSearchSelection, the only difference is the sbi_match_type filter and the new_since filter

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

cityArray of cities.  Businesses match if they are located in either of these cities, thus if the establishment address is in one of these cities.
postcodeArray of postcodes or parts of postcodes.  Businesses 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.
sbiArray 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_onlyMatch 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_formArray of integer legal form codes.  Businesses match if they have either of these legalforms.  A list of legal form codes can be found in the documentation of DutchBusinessDossierV2.
employees_minMinimum number of employees working at the business.
employees_maxMaximum number of employees working at the business.
economically_activeIndicates whether the businesses should be economically active.
activeOnly economically active businesses match.
inactiveOnly economically inactive businesses match.
financial_statusIndicates the financial status of the businesses.
bankruptOnly bankrupt businesses match.
dipOnly businesses which are debtor in possession match.
solventOnly businesses which are neither bankrupt nor debtor in possession match.
insolventOnly businesses which are either bankrupt or debtor in posession match.
changed_sinceDateTime in yyyy-mm-dd hh:mm:ss format.  Time may be omitted and defaults to 00:00:00.  Businesses match if the information about them changed from this DateTime on.
new_sinceDateTime in yyyy-mm-dd hh:mm:ss format.  Time may be omitted and defaults to 00:00:00.  The most recent date possible is the day before the request is done.  Only businesses which were added on or after this DateTime 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 DutchBusiness database.
pagePage to retrieve, pages start counting at 1
provincesArray of Dutch province names or codes according to ISO 3166-2:NL.  ISO 3166-2 defines codes for the names of the principal subdivisions.  Example of ISO 3166-2 see ISO-codes Returns:
outA Patterns::{Type}PagedResult of DutchBusinessReference.

dutchBusinessGetSBIDescription

Look up a SBI (‘Standaard Bedrijfs Indeling 2008’) code.  Returns the section and its description, and all levels of SBI codes and their description, according to the 17-04-2014 version.

Parameters

sbi_codeA SBI code, a number between 2 and 6 characters.
languagethe language of the resulted sbi code descriptions
nlDutch (default)
enEnglish

Returns

outA DutchBusinessSBICodeInfo .

dutchBusinessGetAnnualFinancialStatement

Request an annual financial statement document for a dutch-business.

Parameters

dossier_numberChamber of Commerce number
yearThe year of the financial statement
typeThe type of the financial statement
ORIGINALThe financial statement as deposited originally (PDF)
STANDARDIZEDThe financial statement in standardized format after processing (XBRL)

Returns

outDutchBusinessAnnualFinancialStatement

Extract Document

dutchBusinessGetExtractDocument

Get an extract document in PDF, containing the available Chamber of Commerce data for a business.  The document is generated using the business’ `Online inzage uittreksel`.

Parameters

dossier_numberChamber of Commerce number
allow_cachingDetermines whether a cached document may be returned:
falseThe returned document is up-to-date.
trueThe returned document may be older.  The date of the document is included in the output, see DutchBusinessExtractDocument.

Returns

outA DutchBusinessExtractDocument.

dutchBusinessGetExtractDocumentData

Get the data from an extract document containing the available Chamber of Commerce data for a business.  The document is generated using the business’ `Online inzage uittreksel`.

Parameters

dossier_numberChamber of Commerce number
allow_cachingDetermines whether a cached document may be returned:
falseThe returned document is up-to-date.
trueThe returned document may be older.  The date of the document is included in the output, see DutchBusinessExtractDocumentData.

Returns

outA DutchBusinessExtractDocumentData.

dutchBusinessGetExtractDocumentDataV2

Get the extract data and document for a business dossier

Parameters

dossier_numberChamber of Commerce number

Returns

outA DutchBusinessExtractDocumentDataV2.

dutchBusinessGetExtractDocumentDataV3

Get the extract data and document for a business dossier

Parameters

dossier_numberChamber of Commerce number
include_sourceWhen set the original source is added to the response

Returns

outA DutchBusinessExtractDocumentDataV3.

dutchBusinessGetLegalExtractDocumentDataV2

Get the legal extract data and document for a business dossier

Parameters

dossier_numberChamber of Commerce number

Returns

outA DutchBusinessExtractDocumentDataV2.

dutchBusinessGetLegalExtractDocumentDataV3

Get the legal extract data and document for a business dossier

Parameters

dossier_numberChamber of Commerce number
include_sourceWhen set the original source is added to the response

Returns

outA DutchBusinessExtractDocumentDataV3.

dutchBusinessGetExtractHistory

Get a list of historical business-extract references for the given company or organisation collected by Webservices.nl.  Each business-extract reference in the history contains a summary of the changes relative to the previous business-extract reference in the history.  The business-extract history also contains an forecast that indicates whether changes have occured between the latest business-extract document and the current state or the organisation.  When changes are detected the most recent document in the history probably does not represent the current state of the organisation.  A realtime document can be retrieved using dutchBusinessGetExtractDocumentData or dutchBusinessGetExtractDocument.

Parameters

dossier_numberChamber of Commerce number.
period_start_dateThe start date of the period of historic documents.
period_end_dateThe end date of the set period, can differ max one year from start date.  [optional][default:today]

Returns

outA DutchBusinessExtractHistory.

dutchBusinessGetExtractHistoryChanged

Get a list of historical business-extract references for the given company or organisation collected by Webservices.nl that contain changes compared to their previous retrieved extract.

Parameters

dossier_numberChamber of Commerce number.
period_start_dateThe start date of the period of historic documents.
period_end_dateThe end date of the set period.  [optional][default:today]

Returns

outA DutchBusinessExtractHistory.

See

dutchBusinessGetExtractHistory

dutchBusinessGetExtractHistoryDocumentData

Retrieve a historical business-extract using a business-extract identifier.  Business-extract identifiers can be found using dutchBusinessGetExtractHistory.

Parameters

extract_idBusiness-extract identifier

Returns

outA DutchBusinessExtractDocumentData.

dutchBusinessGetExtractHistoryDocumentDataV2

Retrieve a historical business-extract using a business-extract identifier.  Business-extract identifiers can be found using dutchBusinessGetExtractHistory.

Parameters

extract_idBusiness-extract identifier

Returns

outA DutchBusinessExtractDocumentDataV2.

dutchBusinessGetExtractHistoryDocumentDataV3

Retrieve a historical business-extract using a business-extract identifier.  Business-extract identifiers can be found using dutchBusinessGetExtractHistory.

Parameters

extract_idBusiness-extract identifier
include_sourceWhen set the original source is added to the response

Returns

outA DutchBusinessExtractDocumentDataV3.

dutchBusinessGetExtractHistoryDocumentDataV3ByDossier

Parameters

dossier_numberChamber of Commerce number.
include_sourceWhen set the original source is added to the response
period_startPeriod start date, in yyyy-mm-dd format.[optional]
period_endPeriod end date, in yyyy-mm-dd format.  [optional]

Returns

outA DutchBusinessExtractDocumentDataV3.

dutchBusinessGetDossierHistory

Get a list of logged updates for a specific business dossier.

Parameters

dossier_numberChamber of Commerce number.
period_start_datePeriod start date, in yyyy-mm-dd format.
period_end_datePeriod end date, in yyyy-mm-dd format.  The max period is one year.  [optional]

Returns

outA DutchBusinessDossierHistory.

Retrieve updated dossiers

Check when dossiers have changed, in order to keep them up to date.

There are 3 ways to retrieve updated dossiers

These methods return information on the last change on a dossier, so that you can check whether your stored dossiers are still up to date.

dutchBusinessUpdateGetDossiers

Returns a list of all companies (that have been added to the users follow list) 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 dutchBusinessUpdateRemoveDossier prevents it from occurring in this method’s output.  If a dossier from the output list is retrieved using dutchBusinessGetDossier or dutchBusinessGetDossierV2, a second call to dutchBusinessUpdateGetDossiers will not contain the dossier anymore.

For more information see Dutch Business update service methods

Parameters

update_typesA list specifying the types of updates that should be returned.  See Update types for a list of types.  If the type ‘Test’ is specified, an example DutchBusinessUpdateReference is returned with DateLastUpdate set to today, its Update types will contain all the types specified in the request.
pageThe page of results

Returns

outA Patterns::{Type}PagedResult of DutchBusinessUpdateReference entries.  Every DutchBusinessUpdateReference describes a dossier, when it was last updated and what types of updates have occurred since the dossier was last retrieved by the user.

dutchBusinessUpdateCheckDossier

Retrieve information on the last change to a company.

This method can be used to check for updates on specific dossiers, regardless of whether requested dossiers are logged for the user.  A DutchBusinessUpdateReference is returned for the most recent update, if any.  The DutchBusinessUpdateReference 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

dossier_numberChamber of Commerce number
establishment_numberEstablishment number
update_typesThe types of updates to consider.  See Update types for a list of types.  If the type ‘Test’ is specified, a DutchBusinessUpdateReference is returned with DateLastUpdate set to today, its Update types will contain all the types specified in the request.

Returns

outA DutchBusinessUpdateReference describing when the dossier was last updated and what types of updates occurred on that date.

dutchBusinessUpdateGetChangedDossiers

Retrieve dossier numbers for all companies that changed since the given date.

This method returns a Patterns::{Type}PagedResult of DutchBusinessUpdateReference 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_sinceDate in YYYY-MM-DD format.  All dossiers changed on or after this date are returned.  This date may not be more than 365 days ago.
update_typesThe types of updates to consider.  See Update types for a list of types.  This method supports the update type ‘New’ to retrieve dossiers which have been registered with the DutchBusiness since the changed_since date.
pagePage to retrieve, pages start counting at 1

Returns

outA Patterns::{Type}PagedResult of DutchBusinessUpdateReference entries, with information on changed dossiers.

See also

dutchBusinessUpdateCheckDossier

DutchBusinessUpdateGetDossier related service methods

The business update service methods allow you to keep DutchBusiness data up to date at all times.

dutchBusinessUpdateAddDossier

Add a company to the follow list 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 dutchBusinessUpdateGetDossiers.  Before adding the dossier, call dutchBusinessUpdateCheckDossier to make sure you have the latest dossier version.

You do not need to call this method if you have retrieved a dossier using dutchBusinessGetDossier or dutchBusinessGetDossierV2, in which case it has been added automatically.

Parameters

dossier_numberChamber of Commerce number
establishment_numberEstablishment number

Returns

Nothing

dutchBusinessUpdateRemoveDossier

Remove a company from the follow list for which the user (the user whose credentials are used to make the call) wants to receive updates.

Parameters

dossier_numberChamber of Commerce number
establishment_numberEstablishment number

Returns

Nothing

dutchBusinessUpdateGetOverview

Get a complete overview of all the companies that are on the follow list for the user (the user whose credentials are used to make the call).

Parameters

pageThe page to retrieve

Returns

outA paged result of DutchBusinessUpdateSubscription entries.

Dutch Business update service methods

The business update service methods allow you to keep DutchBusiness 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 219876543210’
  • 22-02: Webservices.nl processes an update for dossier ‘1234578 219876543210’
  • 24-02: User requests updates.  A list of updated dossiers is returned, containing dossier ‘1234578 219876543210’.  The user requests the dossier again and is completely up to date now.

Processing updates

Periodically (for example, once a day) make a call to the dutchBusinessUpdateGetDossiers 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 dutchBusinessGetDossier or dutchBusinessGetDossierV2.  After updating, another call to dutchBusinessUpdateGetDossiers 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 dutchBusinessUpdateRemoveDossier should be called instead of dutchBusinessGetDossier or dutchBusinessGetDossierV2.

Removing dossiers

The dutchBusinessUpdateGetDossiers 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 dutchBusinessUpdateRemoveDossier method can be called to prevent receiving updates for the dossier in the future.

Adding dossiers

A call to dutchBusinessGetDossier or dutchBusinessGetDossierV2 automatically logs the requested dossier for future updates.  However, in case you have an existing database with DutchBusiness dossiers you may want to signal that you are interested in updates for those dossiers.  Using dutchBusinessUpdateAddDossier you can add a dossier to your list for updates.  All future updates to the specified dossier will be returned by dutchBusinessUpdateGetDossiers.  Before adding a dossier to your list you should check if your dossier is up to date.  See dutchBusinessUpdateCheckDossier.

Retrieve news related to businesses

The news service provides endpoints with which news items related to businesses can be queried.

dutchBusinessSearchNewsByDossier

Returns news-items for a given company based on dossier number.  Each given item has been scored with a sentiment-number between 0 and 1 indicating whether an article is considered positive or negative news.

Parameters

dossier_numberA dossier number
period_startThe start date from which to collect items [optional].  Can be given in the format YYYY-MM-DD hh:mm:ss.  If only date_from is provided the period of that date until now will be taken.  If no date is given, the last 3 months will be assumed.
period_endThe end date until which to collect items [optional].  Can be given in the format YYYY-MM-DD hh:mm:ss.  When no date_from is provided, a starting date of three months previous will be taken.
sort_orderThe sorting order [optional].  Should be either ‘desc’ for descending or ‘asc’ for ascending.  By default descending is assumed
pageThe page to retrieve

Returns

outA Patterns::{Type}PagedResult of DutchBusinessNewsItem entries.

DutchBusiness UBO methods

dutchBusinessUBOStartInvestigation

Starts a UBO investigation.  Note that a fixed price is subtracted from the user’s account in lieu of a reservation.  The actual cost of the investigation is calculated when the final product is returned.

Parameters

dossier_numberChamber of Commerce number
oldest_extract_dateOldest date from which extracts are allowed to be collected from the cache [optional, YYYY-MM-DD], defaults to 6 months ago
use_updatesUse a real-time extract if an update has occurred between the oldest extract date and now, meaning a possible cached extract is not up to date anymore [optional, defaults to true]

Returns

outDutchBusinessUBOInvestigationToken

See also

dutchBusinessUBOCheckInvestigation, dutchBusinessUBOPickupInvestigation

dutchBusinessUBOCheckInvestigation

Checks the status of an (ongoing) UBO investigation.  The status can either be: pending, finished, expired, error

Parameters

tokenAn investigation token.  Can be requested from dutchBusinessUBOStartInvestigation

Returns

outDutchBusinessUBOInvestigationStatus

See also

dutchBusinessUBOCheckInvestigation, dutchBusinessUBOStartInvestigation

dutchBusinessUBOPickupInvestigation

Pick up the results of the UBO investigation.  Note that results are available for a finite amount of time.

Parameters

tokenAn investigation token. a Token is returned after starting a investigation via dutchBusinessUBOStartInvestigation
include_sourceWhen set the original source is added to the extracts [optional, defaults to false] Note: currently only a PDF is returned in the `document` field.  See DutchBusinessUBOExtract.

Returns

outDutchBusinessUBOInvestigationResult

See also

dutchBusinessUBOStartInvestigation, dutchBusinessUBOCheckInvestigation

dutchBusinessUBOCostsInvestigation

Returns a receipt with specification of costs made for a successfully completed UBO investigation.

Parameters

tokenA UBO investigation token.

Returns

outdutchBusinessUBOCostsInvestigationResult

See also

dutchBusinessUBOPickupInvestigation, dutchBusinessUBOStartInvestigation

dutchBusinessUBOClassifyInvestigation

Classifies natural persons found in a DutchBusinessUBOClassificationResult and tries to resolve the real UBO.  By evaluating all the returned business against a set of rules (called a scenario), the system tries to resolve who is most likely to be the UBO.  Returned DutchBusinessUBOPerson are labelled as one of the following:

UBOthis person is the UBO
UBO Suspectthis person is likely the UBO, but there is not enough information to make a definitive decision
UBO Gatewaythis person is most likely to know who the actual UBO is.

Parameters

tokenUBO investigation token.  Check UBO Investigation statuses for more information.
scenariothe scenario to run.  If left empty the default scenario will be used

Returns

outDutchBusinessUBOClassificationResult

See also

dutchBusinessUBOPickupInvestigation, dutchBusinessUBOStartInvestigation

dutchBusinessGetLei

Retrieve the Lei code and related information for a business using the Chamber of Commerce number.

Parameters

dossier_numberThe Chamber of Commerce number.

Returns

outDutchBusinessGetLeiResult

Deprecated methods

dutchBusinessSearchParameters

Notice

This function is deprecated use dutchBusinessSearchParametersV2 instead.

Parameters

trade_nameName under which the organisation engages in commercial activity
cityCity
streetStreet
postcodePostcode
house_numberHouse number
house_number_additionHouse number addition
telephone_numberTelephone number
domain_nameDomain name or email address, when an email address is given the domain part of that address is used
strict_searchBoolean indicating if only strict matches should be returned, resulting in less matches.
pagePage to retrieve, pages start counting at 1

Returns

outA Patterns::{Type}PagedResult of DutchBusinessReference

See also

dutchBusinessSearchDossierNumber, dutchBusinessGetDossier, dutchBusinessGetDossierV2

Type definitions

DutchBusinessDossier

Information on a business establishment.

update_infoA DutchBusinessUpdateReference with information on the latest update to this establishment.  Compare this information to the result of later calls to dutchBusinessUpdateCheckDossier, in order to keep your data up-to-date.
dossier_numberThe Chamber of Commerce number, consisting of 8 numbers (e.g., 00123456).  This number is unique and will not change as long as the organisation exists.  Subsidiaries (‘Nevenvestigingen’) of the organisation are registered using the same dossier number.
establishment_numberThe unique identifier for this business establishment, consisting of 12 numbers (e.g.  012345678912).  Optional.  Some businesses, mainly foundations (`Stichting`), do not have establishments.  In these instances the establishment_number is not returned.
main_establishment_numberThe establishment number for the main establishment of the business.  Optional.
indication_main_establishmentBoolean indicating if this is the main establishment of the business.
rsin_numberThe 9 number RSIN (`Rechtspersonen Samenwerkingsverbanden Informatie Nummer`) identifying the business’ legal entity.  Optional, businesses with a sole proprietor (`eenmanszaken`) do not have an rsin_number.
chamber_numberThe chamber number is the number of the Chamber of Commerce office which manages this dossier.  See DutchBusinessDossierV3.
legal_form_codeRegistered legal form used by the organisation.  See DutchBusinessDossierV3
legal_form_textDescription of the legal form (in Dutch).
indication_organisation_codeFor possible values see DutchBusinessDossierV3.

Name

legal_nameThe legal name of the business, or legal personality (`rechtspersoon`)
trade_name_45Primary name under which the business engages in commercial activity.  Shortened to a maximum of 45 characters.
trade_name_fullPrimary name under which the business engages in commercial activity.  This is the full name, up to 132 characters long.
trade_namesAlternative trade names used by the establishment.  Optional.

Establishment Address

establishment_postcodePostcode of the establishment address of the business.  A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2.
establishment_cityCity of the establishment address of the business
establishment_streetStreet of the establishment address of the business
establishment_house_numberHouse number of the establishment address of the business
establishment_house_number_additionHouse number addition of the establishment address of the business

Correspondence Address

correspondence_postcodePostcode of the correspondence address of the business.  A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2.
correspondence_cityCity of the correspondence address of the business
correspondence_streetStreetname the correspondence address of the business
correspondence_house_numberHouse number of the correspondence address of the business
correspondence_house_number_additionHouse number addition of the correspondence address of the business
correspondence_countryISO3 Country code for the correspondence address.

Contact

telephone_numberTelephone number of the establishment.  The first 3 characters contain the area code (Dutch: ‘netnummer’), the last 7 characters the subscriber number (Dutch: ‘abbonnee nummer’).
mobile_numberMobile number
domain_nameThe internet domain name registered by the business

Contact person

contact_title1Title of the contact person of this business.
contact_title2Second title of the contact person of this business.
contact_initialsInitials of the contact.
contact_prefixName prefix of the contact.
contact_surnameSurname of the contact.
contact_genderGender of the contact.
mMale
fFemale
emptyGender unknown

SBI activity codes

primary_sbi_codeThe primary SBI code describing the type of economic or social activity this organisation is associated with.  May be empty.
secondary_sbi_code1First of two secondary SBI codes describing the types of economic or social activity this organisation is associated with.  May be empty.
secondary_sbi_code2Second of two secondary SBI codes describing the types of economic or social activity this organisation is associated with.  May be empty.
primary_sbi_code_textDescription of the primary economic or social activity (in Dutch).
secondary_sbi_code1_textDescription of the first secondary economic or social activity (in Dutch).
secondary_sbi_code2_textDescription of the second secondary economic or social activity (in Dutch).

Personnel

personnelThe total number of employees (full-time and part-time) at this establishment.
class_personnelA classification of the total number of employees (full-time and part-time).  See DutchBusinessDossierV3
personnel_fulltimeThe number of full time employees
class_personnel_fulltimeA classification of the number of full time employees.  See class_personnel for the possible values.
personnel_reference_dateA DutchBusinessDate.  The reference date (peildatum) of the number of employees

Status

indication_importIndication of whether the company does import.  Optional.
indication_exportIndication of whether the company does export.  Optional.
indication_economically_activeBoolean 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.
indication_non_mailingBoolean 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.
indication_bankruptcyBoolean indicating if the business is currently registered as bankrupt (Dutch: ‘Faillissement’).
indication_dipBoolean indicating if the business is currently registered as Debtor-in-Possession (Dutch: ‘in Surseance’).

Capital

authorized_share_capitalNumber 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.
authorized_share_capital_currencyCurrency for AuthorizedShareCapital.  Optional.
paid_up_share_capitalNumber 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.
paid_up_share_capital_currencyCurrency for PaidUpShareCapital.  Optional.
issued_share_capitalNumber indicating the amount of issued share capital.  This is the amount for which the company has issued shares.  Dutch: `geplaatst kapitaal`.  Optional.
issued_share_capital_currencyCurrency for IssuedShareCapital.  Optional.

Dates

founding_dateA DutchBusinessDate indicating the founding date of the company.  Optional.
continuation_dateA DutchBusinessDate indicating the continuation date of the company, if applicable.  This is usually the date that the company changed legal form.  Optional.
establishment_dateA DutchBusinessDate indicating the date the establishment started its activities.  This date does not change when the establishment moves to another location.  Optional.

DutchBusinessGetConcernRelationsOverviewResult

Information about the Corporate Group Relationships aka ‘concernrelaties’ structure of a single business

referencesA Patterns::{Type}Array of DutchBusinessGetConcernRelationsOverviewReference entries

DutchBusinessGetConcernRelationsOverviewReference

Basic information about the Corporate Group Relationships aka ‘concernrelaties’ structure of a Dutch business.

nameThe legal name of the highest known entity of the Corporate group
dossier_numberThe Chamber of Commerce dossier number of the highest known entity of the Corporate group
levelsThe depth of the tree (top to bottom)
level_of_matched_registrationThe level where the current company is located at
registrationsThe total amount of registrations

DutchBusinessGetConcernRelationsDetailsResult

Detailed information about the Corporate Group Relationships aka ‘concernrelaties’ structure of a single business.  Returns all known data of the entire Corporate Group.

dossier_numberThe Chamber of Commerce dossier number of the requested entity of the Corporate group
graphA DutchBusinessGetConcernRelationsDetailsGraph containing the Corporate Group structure
pdfBase64 encoded document in PDF format
sourceBase64 encoded source data, containing the data from the original source

DutchBusinessGetConcernRelationsDetailsGraph

A graph containing the concern structure of a business

nodesA Patterns::{Type}Array of DutchBusinessGetConcernRelationsDetailsGraphNode entries
linksA Patterns::{Type}Array of DutchBusinessGetConcernRelationsDetailsGraphLink entries

DutchBusinessGetConcernRelationsDetailsGraphNode

A node representing a business

idThe Chamber of Commerce number of the business
nameThe name of the business

DutchBusinessGetConcernRelationsDetailsGraphLink

A relation between two businesses

sourceThe first business in the relation
targetThe second business in the relation
typeThe type of relation between the two businesses

DutchBusinessDossierV2

Information on a business establishment including information related to finance and structure.

update_infoA DutchBusinessUpdateReference with information on the latest update to this establishment.  Compare this information to the result of later calls to dutchBusinessUpdateCheckDossier, in order to keep your data up-to-date.
dossier_numberThe Chamber of Commerce number, consisting of 8 numbers (e.g., 00123456).  This number is unique and will not change as long as the organisation exists.  Subsidiaries (‘Nevenvestigingen’) of the organisation are registered using the same dossier number.
establishment_numberThe unique identifier for this business establishment, consisting of 12 numbers (e.g.  012345678912).  Optional.  Some businesses, mainly foundations (`Stichting`), do not have establishments.  In these instances the establishment_number is not returned.
main_establishment_numberThe establishment number for the main establishment of the business.  Optional.
indication_main_establishmentBoolean indicating if this is the main establishment of the business.
rsin_numberThe 9 number RSIN (`Rechtspersonen Samenwerkingsverbanden Informatie Nummer`) identifying the business’ legal entity.  Optional, businesses with a sole proprietor (`eenmanszaken`) do not have an rsin_number.
chamber_numberThe chamber number is the number of the Chamber of Commerce office which see DutchBusinessDossierV3 for possible values.
legal_form_codeRegistered legal form used by the organisation.
legal_form_textDescription of the legal form (in Dutch). see DutchBusinessDossierV3 for possible values.
indication_organisation_codesee DutchBusinessDossierV3 for possible values.

Name

legal_nameThe legal name of the business, or legal personality (`rechtspersoon`)
trade_name_45Primary name under which the business engages in commercial activity.  Shortened to a maximum of 45 characters.
trade_name_fullPrimary name under which the business engages in commercial activity.  This is the full name, up to 132 characters long.
trade_namesAlternative trade names used by the establishment.  Optional.

Establishment Address

establishment_postcodePostcode of the establishment address of the business.  A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2.
establishment_cityCity of the establishment address of the business
establishment_streetStreet of the establishment address of the business
establishment_house_numberHouse number of the establishment address of the business
establishment_house_number_additionHouse number addition of the establishment address of the business

Correspondence Address

correspondence_postcodePostcode of the correspondence address of the business.  A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2.
correspondence_cityCity of the correspondence address of the business
correspondence_streetStreetname the correspondence address of the business
correspondence_house_numberHouse number of the correspondence address of the business
correspondence_house_number_additionHouse number addition of the correspondence address of the business
correspondence_countryISO3 Country code for the correspondence address.

Contact

telephone_numberTelephone number of the establishment.  The first 3 characters contain the area code (Dutch: ‘netnummer’), the last 7 characters the subscriber number (Dutch: ‘abbonnee nummer’).
mobile_numberMobile number
domain_nameThe internet domain name registered by the business

Contact person

contact_title1Title of the contact person of this business.
contact_title2Second title of the contact person of this business.
contact_initialsInitials of the contact.
contact_prefixName prefix of the contact.
contact_surnameSurname of the contact.
contact_genderGender of the contact.
mMale
fFemale
emptyGender unknown

SBI activity codes

primary_sbi_codeThe primary SBI code describing the type of economic or social activity this organisation is associated with.  May be empty.
secondary_sbi_code1First of two secondary SBI codes describing the types of economic or social activity this organisation is associated with.  May be empty.
secondary_sbi_code2Second of two secondary SBI codes describing the types of economic or social activity this organisation is associated with.  May be empty.
primary_sbi_code_textDescription of the primary economic or social activity (in Dutch).
secondary_sbi_code1_textDescription of the first secondary economic or social activity (in Dutch).
secondary_sbi_code2_textDescription of the second secondary economic or social activity (in Dutch).

Personnel

personnelThe total number of employees (full-time and part-time) at this establishment.
class_personnelA classification of the total number of employees (full-time and part-time). see DutchBusinessDossier for possible values.
personnel_fulltimeThe number of fulltime employees
class_personnel_fulltimeA classification of the number of fulltime employees.  See class_personnel for the possible values.
personnel_reference_dateA DutchBusinessDateV2.  The reference date (peildatum) of the number of employees*
personnel_ciThe total number of employees as recorded by the company.info software
class_personnel_ciSee class_personnel for the possible values.
personnel_ci_reference_dateA DutchBusinessDateV2.  The reference date (peildatum) of the number of employees recorded by company.info

Status

indication_importIndication of whether the company does import.  Optional.
indication_exportIndication of whether the company does export.  Optional.
indication_economically_activeBoolean 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.
indication_non_mailingBoolean 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.
indication_bankruptcyBoolean indicating if the business is currently registered as bankrupt (Dutch: ‘Faillissement’).
indication_dipBoolean indicating if the business is currently registered as Debtor-in-Possession (Dutch: ‘in Surseance’).

Capital

authorized_share_capitalNumber 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.
authorized_share_capital_currencyCurrency for AuthorizedShareCapital.  Optional.
paid_up_share_capitalNumber 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.
paid_up_share_capital_currencyCurrency for PaidUpShareCapital.  Optional.
issued_share_capitalNumber indicating the amount of issued share capital.  This is the amount for which the company has issued shares.  Dutch: `geplaatst kapitaal`.  Optional.
issued_share_capital_currencyCurrency for IssuedShareCapital.  Optional.

Dates

founding_dateA DutchBusinessDateV2 indicating the founding date of the company.  Optional.
discontinuation_dateA DutchBusinessDateV2 The date when the business was discontinued (Dutch: datum wanneer de activiteiten gestaakt zijn)
continuation_dateA DutchBusinessDateV2 indicating the continuation date of the company, if applicable.  This is usually the date that the company changed legal form.  Optional.
establishment_dateA DutchBusinessDateV2 indicating the date the establishment started its activities.  This date does not change when the establishment moves to another location.  Optional.

Other

annual_financial_statement_summaryFinancial summary from the last known annual financial statement DutchBusinessAnnualFinancialStatementSummary.
structureInformation regarding the structure of the organization DutchBusinessStructure.
sbi_collectionCollection of SBI’s DutchBusinessSBICollection

DutchBusinessDossierV3

Information on a business establishment including information related to finance and structure.

update_infoA DutchBusinessUpdateReference with information on the latest update to this establishment.  Compare this information to the result of later calls to dutchBusinessUpdateCheckDossier, in order to keep your data up-to-date.
dossier_numberThe Chamber of Commerce number, consisting of 8 numbers (e.g., 00123456).  This number is unique and will not change as long as the organisation exists.  Subsidiaries (‘Nevenvestigingen’) of the organisation are registered using the same dossier number.
establishment_numberThe unique identifier for this business establishment, consisting of 12 numbers (e.g.  012345678912).  Optional.  Some businesses, mainly foundations (`Stichting`), do not have establishments.  In these instances the establishment_number is not returned.
main_establishment_numberThe establishment number for the main establishment of the business.  Optional.
indication_main_establishmentBoolean indicating if this is the main establishment of the business.
rsin_numberThe 9 number RSIN (`Rechtspersonen Samenwerkingsverbanden Informatie Nummer`) identifying the business’ legal entity.  Optional, businesses with a sole proprietor (`eenmanszaken`) do not have an rsin_number.
chamber_numberThe chamber number is the number of the Chamber of Commerce office which manages this dossier.
01Noord Nederland
08Oost Nederland
09Centraal Gelderland
14Limburg
17Brabant
20Zuid West Nederland
24Rotterdam
27Den Haag
30Midden Nederland
32Gooi-, Eem- en Flevoland
34Amsterdam
37Noordwest-Holland
legal_form_codeRegistered legal form used by the organisation.
legal_form_textDescription of the legal form (in Dutch).  Possible combinations of Legalformcode and LegalformcodeText are:
1Eenmanszaak
2Eenmanszaak met meer dan één eigenaar
3NV / BV in oprichting op A-formulier
5Rederij
7Maatschap
11Vennootschap onder firma
12NV / BV in oprichting op B-formulier
21Commanditaire Vennootschap met één beherende vennoot
22Commanditaire Vennootschap met meer dan één beherende vennoot
23NV / BV in oprichting op D-formulier
40Rechtspersoon in oprichting
41Besloten Vennootschap met gewone structuur
42Besloten Vennootschap blijkens statuten structuurvennootschap
51Naamloze Vennootschap met gewone structuur
52Naamloze Vennootschap blijkens statuten structuurvennootschap
53Naamloze Vennootschap beleggingsmaatschappij met veranderlijk kapitaal
54NV beleggingsmaatschappij met veranderlijk kapitaal blijkens statuten structuurvennootschap
55Europese naamloze vennootschap (SE)
56Europese naamloze vennootschap (SE) blijkens statuten structuurvennootschap
61Coöperatie U.A. met gewone structuur
62Coöperatie U.A. blijkens statuten structuurcoöperatie
63Coöperatie W.A. met gewone structuur
64Coöperatie W.A. blijkens statuten structuurcoöperatie
65Coöperatie B.A. met gewone structuur
66Coöperatie B.A. blijkens statuten structuurcoöperatie
70Vereniging van Eigenaars
71Vereniging met volledige rechtsbevoegdheid
72Vereniging met beperkte rechtsbevoegdheid
73Kerkgenootschap
74Stichting
81Onderlinge waarborgmaatschappij U.A. met gewone structuur
82Onderlinge waarborgmaatschappij U.A. blijkens statuten structuuronderlinge
83Onderlinge waarborgmaatschappij W.A. met gewone structuur
84Onderlinge waarborgmaatschappij W.A. blijkens statuten structuuronderlinge
85Onderlinge waarborgmaatschappij B.A. met gewone structuur
86Onderlinge waarborgmaatschappij B.A. blijkens statuten structuuronderlinge
88Publiekrechtelijke rechtspersoon
89Privaatrechtelijke rechtspersoon
91Buitenlandse rechtsvorm met hoofdvestiging in Nederland
92Nevenvestiging met hoofdvestiging in buitenland
93Europees Economisch Samenwerkingsverband
94Buitenlandse EG-vennootschap met onderneming in Nederland
95Buitenlandse EG-vennootschap met hoofdnederzetting in Nederland
96Buitenlandse op EG-vennootschap lijkende vennootschap met onderneming in Nederland
97Buitenlandse op EG-vennootschap lijkende vennootschap met hoofdnederzetting in Nederland
indication_organisation_codePossible values:
OBusiness (Dutch: ‘Onderneming)
VAssociation (Dutch: ‘Vereniging’)
SNon-profit organisation (Dutch: ‘Stichting’)
KChurch community (Dutch: ‘Kerkgenootschap’)
emptyUnknown

Name

legal_nameThe legal name of the business, or legal personality (`rechtspersoon`)
trade_name_45Primary name under which the business engages in commercial activity.  Shortened to a maximum of 45 characters.
trade_name_fullPrimary name under which the business engages in commercial activity.  This is the full name, up to 132 characters long.
trade_namesAlternative trade names used by the establishment.  Optional.

Addresses

establishment_addressA DutchBusinessFormattedAddress entry.
correspondence_addressA DutchBusinessFormattedAddress entry.

Contact

telephone_numberTelephone number of the establishment.  The first 3 characters contain the area code (Dutch: ‘netnummer’), the last 7 characters the subscriber number (Dutch: ‘abbonnee nummer’).
mobile_numberMobile number
domain_nameThe internet domain name registered by the business

Contact person

contact_title1Title of the contact person of this business.
contact_title2Second title of the contact person of this business.
contact_initialsInitials of the contact.
contact_prefixName prefix of the contact.
contact_surnameSurname of the contact.
contact_genderGender of the contact.
mMale
fFemale
emptyGender unknown

SBI activity codes

primary_sbi_codeThe primary SBI code describing the type of economic or social activity this organisation is associated with.  May be empty.
secondary_sbi_code1First of two secondary SBI codes describing the types of economic or social activity this organisation is associated with.  May be empty.
secondary_sbi_code2Second of two secondary SBI codes describing the types of economic or social activity this organisation is associated with.  May be empty.
primary_sbi_code_textDescription of the primary economic or social activity (in Dutch).
secondary_sbi_code1_textDescription of the first secondary economic or social activity (in Dutch).
secondary_sbi_code2_textDescription of the second secondary economic or social activity (in Dutch).

Personnel

personnelThe total number of employees (full-time and part-time) at this establishment.
class_personnelA classification of the total number of employees (full-time and part-time).  Possible values:
1no employees
21 employee
32 to 4 employees
45 to 9 employees
510 to 19 employees
620 to 49 employees
750 to 99 employees
8100 to 199 employees
9199 to 499 employees
10500 to 749 employees
11750 to 999 employees
121000 or more employees
personnel_fulltimeThe number of fulltime employees
class_personnel_fulltimeA classification of the number of fulltime employees.  See class_personnel for the possible values.
personnel_reference_dateA DutchBusinessDateV3.  The reference date (peildatum) of the number of employees*
personnel_ciThe total number of employees as recorded by the company.info software
class_personnel_ciSee class_personnel for the possible values.
personnel_ci_reference_dateA DutchBusinessDateV3.  The reference date (peildatum) of the number of employees recorded by company.info

Status

indication_importIndication of whether the company does import.  Optional.
indication_exportIndication of whether the company does export.  Optional.
indication_economically_activeBoolean 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.
indication_non_mailingBoolean 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.
indication_bankruptcyBoolean indicating if the business is currently registered as bankrupt (Dutch: ‘Faillissement’).
indication_dipBoolean indicating if the business is currently registered as Debtor-in-Possession (Dutch: ‘in Surseance’).

Insolvency

insolvenciesA Patterns::{Type}Array of DutchBusinessInsolvency entries containing data about the insolvencies.  [optional]

Capital

authorized_share_capitalNumber 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.
authorized_share_capital_currencyCurrency for AuthorizedShareCapital.  Optional.
paid_up_share_capitalNumber 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.
paid_up_share_capital_currencyCurrency for PaidUpShareCapital.  Optional.
issued_share_capitalNumber indicating the amount of issued share capital.  This is the amount for which the company has issued shares.  Dutch: `geplaatst kapitaal`.  Optional.
issued_share_capital_currencyCurrency for IssuedShareCapital.  Optional.

Dates

founding_dateA DutchBusinessDateV3 indicating the founding date of the company.  Optional.
discontinuation_dateA DutchBusinessDateV3 The date when the business was discontinued (Dutch: datum wanneer de activiteiten gestaakt zijn)
continuation_dateA DutchBusinessDateV3 indicating the continuation date of the company, if applicable.  This is usually the date that the company changed legal form.  Optional.
establishment_dateA DutchBusinessDateV3 indicating the date the establishment started its activities.  This date does not change when the establishment moves to another location.  Optional.

Other

annual_financial_statement_summaryFinancial summary from the last known annual financial statement DutchBusinessAnnualFinancialStatementSummary.
structureInformation regarding the structure of the organization DutchBusinessStructure.
sbi_collectionCollection of SBI’s DutchBusinessSBICollection

DutchBusinessAnnualFinancialStatementSummary

Summarized information from the last annual financial statement.

yearThe year covered in the financial statement
turnoverThe turnover realised in the financial year DutchBusinessMoneyV2
profitThe profit realised in the financial year DutchBusinessMoneyV2
assetsThe amount of assets for the financial year DutchBusinessMoneyV2

DutchBusinessStructure

Information about the structure of the organization.

ultimate_parentThe Chamber of Commerce number of the ultimate parent organization.  This number consists of 8 numbers (e.g., 00123456).  This number can be used to retrieve the ultimate parent organization using: dutchBusinessGetDossierV2 or dutchBusinessGetDossier
number_of_subsidiariesThe number of subsidiaries this organization controls.
parentThe Chamber of Commerce number of the immediate parent organization.

DutchBusinessExtractDocument

An extract document containing the available Chamber of Commerce data for a business.  The document is generated using the business’ `Online inzage uittreksel`.

documentBase64 encoded document in PDF format
document_dateThe date and time on which the document was generated

DutchBusinessExtractDocumentData

An extract docdateRement containing the available Chamber of Commerce data for a business.  The document is generated using the business’ `Online inzage uittreksel`.

documentBase64 encoded document in PDF format
dossier_numberThe Chamber of Commerce number, consisting of 8 numbers (e.g., 00123456).
establishment_numberThe establishment number (12 digits), optional.
statusStatus description of the business, optional.  Can contain additional information, such as bankrtcy details.
document_dateThe date and time on which the document was generated
legal_entityThe DutchBusinessLegalEntity entry for the business, optional.  (Dutch: rechtspersoon)
enterpriseThe DutchBusinessEnterprise entry for the business, optional.  (Dutch: onderneming)
partnershipA Patterns::{Type}Array of DutchBusinessPartnership entries, optional.  (Dutch: samenwerkingsverband) Each of the entries contains data on the partners/partnerships
establishmentsA Patterns::{Type}Array of DutchBusinessEstablishment entries, optional.  (Dutch: vestigingen)
positionsA Patterns::{Type}Array of DutchBusinessPosition entries, optional.  (Dutch: personen/posities)

DutchBusinessExtractDocumentDataV2

documentBase64 encoded document in PDF format.
dataA DutchBusinessExtractDataV2 entry.

DutchBusinessExtractDocumentDataV3

documentBase64 encoded document in PDF format.
dataA DutchBusinessExtractDataV3 entry.
sourceBase64 encoded source data, containing the data from the original source

DutchBusinessExtractDataV2

dossier_numberThe Dossier number of the ExtractData.
reference_dateThe Reference date of the ExtractData.
legal_entityA DutchBusinessLegalEntityV2 entry.
partnershipA DutchBusinessPartnershipV2 entry.
enterpriseA DutchBusinessEnterpriseV2 entry.
establishmentsA Patterns::{Type}Array of DutchBusinessEstablishmentV2
positionsA Patterns::{Type}Array of DutchBusinessPositionV2
remarksThe Remark(s) of the ExtractData.

DutchBusinessExtractDataV3

dossier_numberThe Dossier number of the ExtractData.
reference_dateThe Reference date of the ExtractData.
legal_entityA DutchBusinessLegalEntityV3 entry.
partnershipA DutchBusinessPartnershipV3 entry.
enterpriseA DutchBusinessEnterpriseV3 entry.
establishmentsA Patterns::{Type}Array of DutchBusinessEstablishmentV3
positionsA Patterns::{Type}Array of DutchBusinessPositionV3
remarksThe Remark(s) of the ExtractData.

DutchBusinessPositions

dossier_numberThe Dossier number of the ExtractData.
reference_dateThe Reference date of the ExtractData.
positionsA Patterns::{Type}Array of DutchBusinessPositionV2

DutchBusinessLegalEntityData

dossier_numberThe Dossier number of the ExtractData.
reference_dateThe Reference date of the ExtractData.
legal_entityA DutchBusinessLegalEntityV3 entry

DutchBusinessLegalEntity

The legal entity of the requested dossier (`Rechtspersoon`).  All elements are optional.

rsin_numberThe 9 number RSIN (`Rechtspersonen Samenwerkingsverbanden Informatie Nummer`) identifying the business’ legal entity.  Optional, businesses with a sole proprietor (`eenmanszaken`) do not have a rsin_number.
nameName of the business
alternative_nameAlternative name of the business Not yet available: ook genoemd
shortened_nameShort name of the business Not yet available: verkorte naam
registrationDescription of the registration of the business (Dutch: geregistreerd/ingeschreven in)
statusStatus of the legal entity.  Can contain details about the legal entity.  For example, bankruptcy information (Dutch: status/bijzonderheden)
legal_form_textDescription of the legal form (Dutch: rechtsvorm)
legal_form_changeDescription when the legal form changed Not yet available: rechtsvorm wijziging
foreign_legal_form_descriptionHow the business is registered abroad (Dutch: beschrijving buitenlandse rechtsvorm)
sbi_codesThe sbi code(s) for the business, can contain more than one code (Dutch: SBI-codes)
sbi_codes_textThe description(s) of the sbi code(s) as given in sbi_codes (Dutch: SBI-beschrijvingen)
activityDescription of the activity
company_arrangementThe company arrangement (Dutch: stelsel inrichting)
legal_nameThe legal name of the business (Dutch: statutaire naam)
statutory_seatThe place where the business is legally seated (Dutch: statutaire zetel)
registration_dateDutchBusinessDate Date when the business was registered (Dutch: datum eerste inschrijving handelsregister)
founding_dateDutchBusinessDate Date when the business was founded (Dutch: datum van oprichting)
discontinuation_dateDutchBusinessDate Date when the business was discontinued (Dutch: datum wanneer de activiteiten gestaakt zijn)
dissolution_dateDutchBusinessDate Date when the business was dissolved (Dutch: datum van ontbinding)
dissolution_reasonThe reason why the business was dissolved (Dutch: reden van ontbinding)
removal_dateDutchBusinessDate The business removal date Not yet available: datum opheffing
registration_end_dateDutchBusinessDate Date when the business was unregistered Not yet available: datum einde inschrijving
legal_entity_end_dateDutchBusinessDate Date when the legal entity was removed or has ended Not yet available: datum einde rechtspersoon
liquidation_closure_dateDutchBusinessDate End date of the liquidation Not yet available: datum einde liquidatie
liquidation_reopening_dateDutchBusinessDate Reopening date of the liquidation Not yet available: datum heropening liquidatie
deed_incorporation_dateDutchBusinessDate Date of the incorporation deed (Dutch: datum akte van oprichting)
deed_last_statutes_amendment_dateDutchBusinessDate Date of the last deed statutes amendment (Dutch: datum akte laatste statutenwijziging)
last_statutes_amendment_dateDutchBusinessDate Date of the last status amendment (Dutch: datum laatste statutenwijziging)
liabilityDescription of the business liability (Dutch: aansprakelijkheid)
merger_descriptionMerger or demerger information ((Dutch: fusie/splitsing beschrijving)
annual_report_submissionDescription of the annual report submission (Dutch: deponering jaarstuk)
authorized_share_capitalNumber indicating the amount of authorized share capital.  The amount of money for which the company is allowed to give out shares.  Dutch: `maatschappelijk kapitaal`.
authorized_share_capital_currencyCurrency for authorized_share_capital.
issued_share_capitalNumber indicating the amount of issued share capital.  This is the amount for which the company has issued shares.  Dutch: `geplaatst kapitaal`.
issued_share_capital_currencyCurrency for issued_share_capital.
paid_up_share_capitalNumber 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`.
paid_up_share_capital_currencyCurrency for paid_up_share_capital.
establishment_postcodePostcode of the establishment address of the business.  A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2.
establishment_cityCity of the establishment address of the business
establishment_streetStreet of the establishment address of the business
establishment_house_numberHouse number of the establishment address of the business
establishment_house_number_additionHouse number addition of the establishment address of the business
establishment_countryCountry of the establishment address of the business
correspondence_postcodePostcode of the correspondence address of the business.  A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2.
correspondence_cityCity of the correspondence address of the business
correspondence_streetStreetname the correspondence address of the business
correspondence_house_numberHouse number of the correspondence address of the business
correspondence_house_number_additionHouse number addition of the correspondence address of the business
correspondence_countryCountry of the the correspondence address.
durationDescription of the duration (Dutch: duur)
duration_end_dateDutchBusinessDate The end date of the duration Not yet available: datum wanneer de duur eindigd
sharesDescription of the shares (Dutch: aandelen beschrijving)
share_holdersDescription of the share holders Not yet available: houders aandelen beschrijving
telephone_numbersThe telephone numbers of the business
fax_numbersThe fax numbers of the business
email_addressesThe email addresses of the business
domain_namesThe domain names of the business

DutchBusinessLegalEntityV2

rsin_numberThe Rsin number of the LegalEntity.
nameThe Name of the LegalEntity.
alternative_nameThe Alternative name of the LegalEntity.
shortened_nameThe Shortened name of the LegalEntity.
registrationThe Registration of the LegalEntity.
legal_form_textThe Legal form text of the LegalEntity.
legal_form_changeThe Legal form change of the LegalEntity.
foreign_legal_form_descriptionThe Foreign legal form description of the LegalEntity.
activityThe Activity of the LegalEntity.
company_arrangementThe Company arrangement of the LegalEntity.
legal_nameThe Legal name of the LegalEntity.
statutory_seatThe Statutory seat of the LegalEntity.
registration_dateA DutchBusinessDateV2 entry.
founding_dateA DutchBusinessDateV2 entry.
discontinuation_dateA DutchBusinessDateV2 entry.
dissolution_dateA DutchBusinessDateV2 entry.
dissolution_reasonThe Dissolution reason of the LegalEntity.
removal_dateA DutchBusinessDateV2 entry.
registration_end_dateA DutchBusinessDateV2 entry.
legal_entity_end_dateA DutchBusinessDateV2 entry.
liquidation_closure_dateA DutchBusinessDateV2 entry.
liquidation_reopening_dateA DutchBusinessDateV2 entry.
deed_incorporation_dateA DutchBusinessDateV2 entry.
deed_last_statutes_amendment_dateA DutchBusinessDateV2 entry.
last_statutes_amendment_dateA DutchBusinessDateV2 entry.
liabilityThe Liability of the LegalEntity.
merger_descriptionThe Merger description of the LegalEntity.
annual_report_submissionThe Annual report submission of the LegalEntity.
authorized_share_capitalA DutchBusinessMoneyV2 entry.
issued_share_capitalA DutchBusinessMoneyV2 entry.
paid_up_share_capitalA DutchBusinessMoneyV2 entry.
durationThe Duration of the LegalEntity.
duration_end_dateA DutchBusinessDateV2 entry.
sharesThe Shares of the LegalEntity.
share_holdersThe Share holders of the LegalEntity.
remarksThe Remark(s) of the LegalEntity.
establishment_addressA DutchBusinessAddressV2 entry.
correspondence_addressA DutchBusinessAddressV2 entry.
telephone_numbersThe Telephone numbers(s) of the LegalEntity.
fax_numbersThe Fax number(s) of the LegalEntity.
email_addressesThe Email address(es) of the LegalEntity.
domain_namesThe Domain name(s) of the LegalEntity.
sbi_codesA Patterns::{Type}Array of DutchBusinessSbiCodeV2

DutchBusinessLegalEntityV3

rsin_numberThe Rsin number of the LegalEntity.
nameThe Name of the LegalEntity.
alternative_nameThe Alternative name of the LegalEntity.
shortened_nameThe Shortened name of the LegalEntity.
registrationThe Registration of the LegalEntity.
legal_form_textThe Legal form text of the LegalEntity.
legal_form_changeThe Legal form change of the LegalEntity.
foreign_legal_form_descriptionThe Foreign legal form description of the LegalEntity.
activityThe Activity of the LegalEntity.
company_arrangementThe Company arrangement of the LegalEntity.
legal_nameThe Legal name of the LegalEntity.
statutory_seatThe Statutory seat of the LegalEntity.
registration_dateA DutchBusinessDateV3 entry.
founding_dateA DutchBusinessDateV3 entry.
discontinuation_dateA DutchBusinessDateV3 entry.
dissolution_dateA DutchBusinessDateV3 entry.
dissolution_reasonThe Dissolution reason of the LegalEntity.
removal_dateA DutchBusinessDateV3 entry.
registration_end_dateA DutchBusinessDateV3 entry.
legal_entity_end_dateA DutchBusinessDateV3 entry.
liquidation_closure_dateA DutchBusinessDateV3 entry.
liquidation_reopening_dateA DutchBusinessDateV3 entry.
deed_incorporation_dateA DutchBusinessDateV3 entry.
deed_last_statutes_amendment_dateA DutchBusinessDateV3 entry.
last_statutes_amendment_dateA DutchBusinessDateV3 entry.
liabilityThe Liability of the LegalEntity.
merger_descriptionThe Merger description of the LegalEntity.
annual_report_submissionThe Annual report submission of the LegalEntity.
authorized_share_capitalA DutchBusinessMoneyV3 entry.
issued_share_capitalA DutchBusinessMoneyV3 entry.
paid_up_share_capitalA DutchBusinessMoneyV3 entry.
durationThe Duration of the LegalEntity.
duration_end_dateA DutchBusinessDateV3 entry.
sharesThe Shares of the LegalEntity.
share_holdersThe Share holders of the LegalEntity.
remarksThe Remark(s) of the LegalEntity.
establishment_addressA DutchBusinessAddressV3 entry.
correspondence_addressA DutchBusinessAddressV3 entry.
telephone_numbersThe Telephone numbers(s) of the LegalEntity.
fax_numbersThe Fax number(s) of the LegalEntity.
email_addressesThe Email address(es) of the LegalEntity.
domain_namesThe Domain name(s) of the LegalEntity.
sbi_codesA Patterns::{Type}Array of DutchBusinessSbiCodeV3

DutchBusinessOrganizationTree

nameThe name of the requested company.
dossier_numberThe chamber of commerce number of the requested company
treeThe root node of the organization tree DutchBusinessOrganizationNode

DutchBusinessOrganizationNode

nameThe name of the liaison.
typeThe type of liaison, can be: -- Ultimate Beneficial Owner (has internal id) -- Company (identified by kvk number) -- Foreign Company (no identifier set)
idThe identifier of the liaison, see type for possible values.  [optional]
childrenA Patterns::{Type}Array of DutchBusinessOrganizationNode containing the children of the node.

DutchBusinessPartnership

A partnership of the requested dossier (`samenwerkingsverband`).  All output elements are optional.

dossier_numberThe Chamber of Commerce number, consisting of 8 numbers (e.g., 00123456).
rsin_numberThe 9 number RSIN (`Rechtspersonen Samenwerkingsverbanden Informatie Nummer`) identifying the business’ legal entity.  Optional, businesses with a sole proprietor (`eenmanszaken`) do not have a rsin_number.
nameName of the partnership
registrationThe description of the registration data, only occures when the registration is no dutch chamber of commerce registration (Dutch: geregistreerd/ingeschreven in)
statusStatus of the partnership.  Can contain any details that about the partnership (Dutch: status/bijzonderheden)
legal_form_textDescription of the legal form (Dutch: rechtsvorm)
founding_dateDutchBusinessDate Date when the business is founded (Dutch: datum van oprichting)
dissolution_dateDutchBusinessDate Date when the business was dissolved (Dutch: datum van ontbinding)
function_start_dateDutchBusinessDate Start date when the business occupies the current position (Dutch: datum in functie)
durationDescription of the duration (Dutch: duur)
limited_partnership_capitalThe limited partnership capital issued (Dutch: commanditair kapitaal)
limited_partnership_capital_currencyThe currency of limited partnership capital (Dutch: commanditair kapitaal valuta)
establishment_postcodePostcode of the establishment address of the partnership.  A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2.
establishment_cityCity of the establishment address of the partnership
establishment_streetStreet of the establishment address of the partnership
establishment_house_numberHouse number of the establishment address of the partnership
establishment_house_number_additionHouse number addition of the establishment address of the partnership
establishment_countryCountry of the establishment address of the partnership
silent_partnersNumber of silent partners (Dutch: aantal stille vennoten)

DutchBusinessPartnershipV2

dossier_numberThe Dossier number of the Partnership.
rsin_numberThe Rsin number of the Partnership.
nameThe Name of the Partnership.
registrationThe Registration of the Partnership.
legal_form_textThe Legal form text of the Partnership.
founding_dateA DutchBusinessDateV2 entry.
dissolution_dateA DutchBusinessDateV2 entry.
function_start_dateA DutchBusinessDateV2 entry.
durationThe Duration of the Partnership.
limited_partnership_capitalA DutchBusinessMoneyV2 entry.
establishment_addressA DutchBusinessAddressV2 entry.
correspondence_addressA DutchBusinessAddressV2 entry.
silent_partnersThe Silent partners of the Partnership.
remarksThe Remark(s) of the Partnership.

DutchBusinessPartnershipV3

dossier_numberThe Dossier number of the Partnership.
rsin_numberThe Rsin number of the Partnership.
nameThe Name of the Partnership.
registrationThe Registration of the Partnership.
legal_form_textThe Legal form text of the Partnership.
founding_dateA DutchBusinessDateV3 entry.
dissolution_dateA DutchBusinessDateV3 entry.
function_start_dateA DutchBusinessDateV3 entry.
durationThe Duration of the Partnership.
limited_partnership_capitalA DutchBusinessMoneyV3 entry.
establishment_addressA DutchBusinessAddressV3 entry.
correspondence_addressA DutchBusinessAddressV3 entry.
silent_partnersThe Silent partners of the Partnership.
remarksThe Remark(s) of the Partnership.

DutchBusinessEnterprise

The enterprise (`onderneming`) of the requested dossier.  All output elements are optional.

rsin_numberThe 9 number RSIN (`Rechtspersonen Samenwerkingsverbanden Informatie Nummer`) identifying the business’ legal entity.  Optional, businesses with a sole proprietor (`eenmanszaken`) do not have a rsin_number.
nameName of the enterprise
registrationThe description of the registration data, only occures when the registration is no dutch chamber of commerce registration (Dutch: geregistreerd/ingeschreven in)
statusStatus of the enterprise.  Can contain any details that about the enterprise (Dutch: status/byzonderheden)
legal_form_textDescription of the legal form (Dutch: rechtsvorm)
trade_namesThe trade names of the enterprise (Dutch: handelsnamen)
activityDescription of the activity (Dutch: activiteit)
descriptionDescription of the business (Dutch: bedrijfsomschrijving)
sbi_codesThe sbi code(s) for the business, can contain more than one code (Dutch: SBI-codes)
sbi_codes_textThe description(s) of the sbi code(s) as given in sbi_code (Dutch: SBI-beschrijvingen)
establishment_postcodePostcode of the establishment address of the business.  A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2.
establishment_cityCity of the establishment address
establishment_streetStreet of the establishment address
establishment_house_numberHouse number of the establishment address
establishment_house_number_additionHouse number addition of the establishment address
establishment_countryCountry of the establishment address
correspondence_postcodePostcode of the correspondence address of the business.  A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2.
correspondence_cityCity of the correspondence address
correspondence_streetStreetname the correspondence address
correspondence_house_numberHouse number of the correspondence address
correspondence_house_number_additionHouse number addition of the correspondence address
correspondence_countryCountry of the the correspondence address.
telephone_numbersThe telephone numbers of the business
fax_numbersThe fax numbers of the business
email_addressesThe email addresses of the business
domain_namesThe domain names of the business
establishment_dateDutchBusinessDate Date when the establishment was started (Dutch: datum vestiging)
incorporation_dateDutchBusinessDate Date when the business was started (Dutch: startdatum onderneming)
founding_dateDutchBusinessDate Date when the business was founded (Dutch: datum van oprichting)
discontinuation_dateDutchBusinessDate Date when the business was discontinued (Dutch: datum wanneer de activiteiten gestaakt zijn)
date_sinceDutchBusinessDate Date the enterprise is managed or owned by the business (Dutch: datum vanaf wanneer de onderneming bestuurd wordt of in eigendom is)
personnelThe number of personnel (Dutch: werkzame personen)

DutchBusinessEnterpriseV2

nameThe Name of the Enterprise.
registrationThe Registration of the Enterprise.
legal_form_textThe Legal form text of the Enterprise.
activityThe Activity of the Enterprise.
descriptionThe Description of the Enterprise.
incorporation_dateA DutchBusinessDateV2 entry.
founding_dateA DutchBusinessDateV2 entry.
discontinuation_dateA DutchBusinessDateV2 entry.
date_sinceA DutchBusinessDateV2 entry.
personnelA DutchBusinessPersonnelInfoV2 entry.
remarksThe Remark(s) of the Enterprise.
sbi_codesA Patterns::{Type}Array of DutchBusinessSbiCodeV2
trade_namesThe Trade name(s) of the Enterprise.

DutchBusinessEnterpriseV3

nameThe Name of the Enterprise.
registrationThe Registration of the Enterprise.
legal_form_textThe Legal form text of the Enterprise.
activityThe Activity of the Enterprise.
descriptionThe Description of the Enterprise.
incorporation_dateA DutchBusinessDateV3 entry.
founding_dateA DutchBusinessDateV3 entry.
discontinuation_dateA DutchBusinessDateV3 entry.
date_sinceA DutchBusinessDateV3 entry.
personnelA DutchBusinessPersonnelInfoV3 entry.
remarksThe Remark(s) of the Enterprise.
sbi_codesA Patterns::{Type}Array of DutchBusinessSbiCodeV3
trade_namesThe Trade name(s) of the Enterprise.

DutchBusinessEstablishment

A establishment (vestiging) of the dossier, dossier can contain more than one establishment.  The output elements within the DutchBusinessEstablishment is optional.

establishment_numberThe establishment number (12 digits)
main_establishmentIndicates that the establishment is the main establishment (Dutch: hoofdvestigings indicator)
statusStatus of the establishment.  Can contain details about the establishment (Dutch: status/bijzonderheden)
legal_form_textDescription of the legal form (Dutch: rechtsvorm)
trade_namesThe trade names of the enterprise (Dutch: handelsnamen)
activityDescription of the activity (Dutch: activiteit)
descriptionDescription of the business (Dutch: bedrijfsomschrijving)
sbi_codesThe sbi code(s) for the business, can contain more than one code (Dutch: SBI-codes)
sbi_codes_textThe description(s) of the sbi code(s) as given in sbi_code (Dutch: SBI-beschrijvingen)
establishment_postcodePostcode of the establishment address of the business.  A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2.
establishment_cityCity of the establishment address
establishment_streetStreet of the establishment address
establishment_house_numberHouse number of the establishment address
establishment_house_number_additionHouse number addition of the establishment address
establishment_countryCountry of the establishment address
correspondence_postcodePostcode of the correspondence address of the business.  A postcode consists of 4 numbers representing the neighborhood code, and a lettercombination of length 2.
correspondence_cityCity of the correspondence address
correspondence_streetStreetname the correspondence address
correspondence_house_numberHouse number of the correspondence address
correspondence_house_number_additionHouse number addition of the correspondence address
correspondence_countryCountry of the correspondence address
curator_postcodeThe postcode of the curator’s address
curator_cityCity of the curator’s address
curator_streetStreet of the curator’s address
curator_house_numberHouse number of the curator’s address
curator_house_number_additionHouse number addition of the curator’s address
curator_countryCountry of the curator’s address
telephone_numbersThe telephone numbers of the business
fax_numbersThe fax numbers of the business
email_addressesThe email addresses of the business
domain_namesThe domain names of the business
establishment_dateDutchBusinessDate Date when the establishment was started (Dutch: datum vestiging)
date_sinceDutchBusinessDate Date from which the establishment is managed or owned by the business (Dutch: datum vanaf de vestiging bestuurd wordt of in eigendom is)
personnelThe number of personnel (Dutch: werkzame personen)

DutchBusinessEstablishmentV2

establishment_numberThe Establishment number of the Establishment.
main_establishmentThe Main establishment of the Establishment.
legal_form_textThe Legal form text of the Establishment.
activityThe Activity of the Establishment.
descriptionThe Description of the Establishment.
establishment_dateA DutchBusinessDateV2 entry.
date_sinceA DutchBusinessDateV2 entry.
personnelA DutchBusinessPersonnelInfoV2 entry.
remarksThe Remarks(s) of the Establishment.
sbi_codesA Patterns::{Type}Array of DutchBusinessSbiCodeV2
establishment_addressA DutchBusinessAddressV2 entry.
correspondence_addressA DutchBusinessAddressV2 entry.
telephone_numbersThe Telephone number(s) of the Establishment.
fax_numbersThe Fax number(s) of the Establishment.
email_addressesThe Email address(es) of the Establishment.
domain_namesThe Domain name(s) of the Establishment.
trade_namesThe Trade name(s) of the Establishment.

DutchBusinessEstablishmentV3

establishment_numberThe Establishment number of the Establishment.
main_establishmentThe Main establishment of the Establishment.
legal_form_textThe Legal form text of the Establishment.
activityThe Activity of the Establishment.
descriptionThe Description of the Establishment.
establishment_dateA DutchBusinessDateV3 entry.
date_sinceA DutchBusinessDateV3 entry.
personnelA DutchBusinessPersonnelInfoV3 entry.
remarksThe Remarks(s) of the Establishment.
sbi_codesA Patterns::{Type}Array of DutchBusinessSbiCodeV3
establishment_addressA DutchBusinessAddressV3 entry.
correspondence_addressA DutchBusinessAddressV3 entry.
telephone_numbersThe Telephone number(s) of the Establishment.
fax_numbersThe Fax number(s) of the Establishment.
email_addressesThe Email address(es) of the Establishment.
domain_namesThe Domain name(s) of the Establishment.
trade_namesThe Trade name(s) of the Establishment.

DutchBusinessPosition

A business position can contain data about a person or business that holds a position within the business.  All output fields for are optional.

trade_namesThe trade names of the enterprise (Dutch: handelsnamen)
dossier_numberThe Chamber of Commerce number, consisting of 8 numbers
establishment_numberThe establishment number (12 digits)
nameName of the position, can be a business name or person name
first_nameFirst name
titleTitle (Dutch: titulatuur)
initialsInitials
last_nameLast name
function_typeFunction type
function_titleFunction title
function_descriptionDescription op the function
function_start_dateDutchBusinessDate Start date function (Dutch:datum in functie)
function_registration_dateDutchBusinessDate Registration date of the function (Dutch:datum functie registratie bij kvk)
function_end_dateDutchBusinessDate Date when the function was resigned Not yet available: datum uit functie
function_authorizationDescription of function authorization (Dutch:functie bevoegdheid)
function_authorization_descriptionDescription of the function authorization Not yet available: inhoud bevoegdheid
function_authorization_start_dateDutchBusinessDate Start date of the function authorization (Dutch: aanvang bevoegdheid)
function_authorization_signing_powerDescription of the signing authority Not yet available: tekenings bevoegdheid
function_authorization_end_dateDutchBusinessDate End date of the function authorization Not yet available: einde bevoegdheid
authorization_descriptionDescription of the authorization (Dutch: inhoud volmacht)
authorization_start_dateDutchBusinessDate Start date of the authorization (Dutch: aanvang (huidige) volmacht)
authorization_end_dateDutchBusinessDate End date of the authorization Not yet available: einde volmacht
inaugurationNot yet available: beëdigd in
inauguration_functionDescription of the function inauguration Not yet available: beëdigd als
inauguration_durationDuration of the inauguration Not yet available: duur beëdiging
inauguration_dateDutchBusinessDate Date of the inauguration Not yet available: datum beëdiging
inauguration_bodyNot yet available: instelling beëdiging
under_receivershipDescription of the under receivership Not yet available: onderbewindstelling
rights_against_third_partiesDescription of the rights against third parties Not yet available: rechten_tov_derden
release_of_covenantRelease of covenant is only set wen the business owner is a minor, it contains the person that is legally liable for the business Not yet available: handlichting_persoon
date_deceasedDutchBusinessDate Date the person was deceased Not yet available: datum van overlijden
date_of_birthDutchBusinessDate The date of birth
place_of_birthThe place of birth
country_of_birthThe country of birth
postcodePostcode of the address of the business position
cityCity of the address
streetStreet of the address
house_numberHouse number of the address
house_number_additionHouse number addition of the address
countryCountry of the address
telephone_numbersTelephone numbers
date_sinceDutchBusinessDate The date on which the person became owner/director or share holder of the business
date_joinedDutchBusinessDate The date on which the person or director joined the company (Dutch: datum toetreding)
statusStatus of the position.  Can contain any details about the position (Dutch: status/bijzonderheden)

DutchBusinessPositionV2

functionaryA DutchBusinessPersonV2 entry.
organisationA DutchBusinessOrganizationReferenceV2 entry.
residential_addressA DutchBusinessAddressV2 entry.
correspondence_addressA DutchBusinessAddressV2 entry.
establishment_addressA DutchBusinessAddressV2 entry.
longest_servingThe Longest serving of the Position.
function_typeThe Function type of the Position.
function_descriptionThe Function description of the Position.
function_titleThe Function title of the Position.
function_start_dateA DutchBusinessDateV2 entry.
function_registration_dateA DutchBusinessDateV2 entry.
function_end_dateA DutchBusinessDateV2 entry.
function_authorizationThe Function authorization of the Position.
function_authorization_descriptionThe Function authorization description of the Position.
function_authorization_start_dateA DutchBusinessDateV2 entry.
function_authorization_signing_powerThe Function authorization signing power of the Position.
function_authorization_end_dateA DutchBusinessDateV2 entry.
authorization_descriptionThe Authorization description of the Position.
authorization_establishment_numberThe Authorization establishment number of the Position.
authorization_start_dateA DutchBusinessDateV2 entry.
authorization_end_dateA DutchBusinessDateV2 entry.
authorization_constraintsThe Authorization constraints(s) of the Position.
inaugurationThe Inauguration of the Position.
inauguration_functionThe Inauguration function of the Position.
inauguration_durationThe Inauguration duration of the Position.
inauguration_dateA DutchBusinessDateV2 entry.
inauguration_bodyThe Inauguration body of the Position.
under_receivershipThe Under receivership of the Position.
rights_against_third_partiesThe Rights against third parties of the Position.
release_of_covenantThe Release of covenant of the Position.
date_sinceA DutchBusinessDateV2 entry.
date_joinedA DutchBusinessDateV2 entry.
remarksThe Remark(s) of the Position.

DutchBusinessPositionV3

functionaryA DutchBusinessPersonV3 entry.
organisationA DutchBusinessOrganizationReferenceV3 entry.
residential_addressA DutchBusinessAddressV3 entry.
correspondence_addressA DutchBusinessAddressV3 entry.
establishment_addressA DutchBusinessAddressV3 entry.
longest_servingThe Longest serving of the Position.
function_typeThe Function type of the Position.
function_descriptionThe Function description of the Position.
function_titleThe Function title of the Position.
function_start_dateA DutchBusinessDateV3 entry.
function_registration_dateA DutchBusinessDateV3 entry.
function_end_dateA DutchBusinessDateV3 entry.
function_authorizationThe Function authorization of the Position.
function_authorization_descriptionThe Function authorization description of the Position.
function_authorization_start_dateA DutchBusinessDateV3 entry.
function_authorization_signing_powerThe Function authorization signing power of the Position.
function_authorization_end_dateA DutchBusinessDateV3 entry.
authorization_descriptionThe Authorization description of the Position.
authorization_establishment_numberThe Authorization establishment number of the Position.
authorization_start_dateA DutchBusinessDateV3 entry.
authorization_end_dateA DutchBusinessDateV3 entry.
authorization_constraintsThe Authorization constraints(s) of the Position.
inaugurationThe Inauguration of the Position.
inauguration_functionThe Inauguration function of the Position.
inauguration_durationThe Inauguration duration of the Position.
inauguration_dateA DutchBusinessDateV3 entry.
inauguration_bodyThe Inauguration body of the Position.
under_receivershipThe Under receivership of the Position.
rights_against_third_partiesThe Rights against third parties of the Position.
release_of_covenantThe Release of covenant of the Position.
date_sinceA DutchBusinessDateV3 entry.
date_joinedA DutchBusinessDateV3 entry.
remarksThe Remark(s) of the Position.

DutchBusinessPersonV2

full_nameThe full name of the Person.
first_nameThe first name of the Person.
titleThe title of the Person.
initialsThe initials of the Person.
last_nameThe last name of the Person.
genderThe gender of the Person [optional].
date_deceasedA DutchBusinessDateV2 entry.
date_of_birthA DutchBusinessDateV2 entry.
place_of_birthThe Place of birth of the Person.
country_of_birthThe Country of birth of the Person.

DutchBusinessPersonV3

full_nameThe full name of the Person.
first_nameThe first name of the Person.
titleThe title of the Person.
initialsThe initials of the Person.
last_nameThe last name of the Person.
genderThe gender of the Person [optional].
date_deceasedA DutchBusinessDateV3 entry.
date_of_birthA DutchBusinessDateV3 entry.
place_of_birthThe Place of birth of the Person.
country_of_birthThe Country of birth of the Person.

DutchBusinessOrganizationReferenceV2

dossier_numberThe dossier number of the Organisation.
registrationThe foreign registration of the Organisation.
nameThe trade name of the Organisation.
trade_namesThe alternative trade name(s) of the Organisation.

DutchBusinessOrganizationReferenceV3

dossier_numberThe dossier number of the Organisation.
registrationThe foreign registration of the Organisation.
nameThe trade name of the Organisation.
trade_namesThe alternative trade name(s) of the Organisation.

DutchBusinessMoneyV2

The money is given in the smallest available units for the currency (EUR -> cents)

amountThe Amount of the Money.
currencyThe Currency of the Money.
formattedThe formatted Money output according to the dutch number format (EUR 1.000,00)

DutchBusinessMoneyV3

The money is given in the smallest available units for the currency (EUR -> cents)

amountThe Amount of the Money.
currencyThe Currency of the Money.
formattedThe formatted Money output according to the dutch number format (EUR 1.000,00)

DutchBusinessPersonnelInfoV2

fulltimeThe number of Fulltime Personnel.
parttimeThe number of Parttime Personnel.
totalThe Total number of Personnel.

DutchBusinessPersonnelInfoV3

fulltimeThe number of Fulltime Personnel.
parttimeThe number of Parttime Personnel.
totalThe Total number of Personnel.

DutchBusinessFormattedAddress

originalA DutchBusinessAddressV3 entry, the address as registered at the kvk.
officialA DutchBusinessAddressV3 entry, the address as found in BAG database [optional] The official address is looked up within the BAG database and can be empty when it is not found.  A house number addition within the official format can be missing when the addition can not be matched with the official spelling.
formattedA DutchBusinessAddressV3 entry, the original address formatted according to the Dutch rules of spelling.

DutchBusinessAddressV2

postcodeThe Postcode of the Address.
cityThe City of the Address.
streetThe Street of the Address.
house_numberThe House number of the Address.
house_number_additionThe House number addition of the Address.
countryThe Country of the Address.

DutchBusinessAddressV3

addressThe complete address as it is added by Chamber of Commerce
postcodeThe Postcode of the Address.
cityThe City of the Address.
streetThe Street of the Address.
house_numberThe House number of the Address.
house_number_additionThe House number addition of the Address.
countryThe Country of the Address.

DutchBusinessSBICodeInfo

Descriptions related to a DutchBusinessSBICode.

sectionA DutchBusinessSBISection
sbi_codesA Patterns::{Type}Array of DutchBusinessSBICode entries

DutchBusinessSBISection

A SBI section code with description.  DutchBusinessSBICode are related to section codes.

section_codeA SBI section code, a capital letter between A and U.
descriptionDescription of the SBI section.

DutchBusinessSBICode

A SBI (‘Standaard Bedrijfs Indeling’) code with description

sbi_codeA SBI code, a number up to six characters in length.
descriptionDescription of the SBI code.

DutchBusinessSbiCodeV2

sbi_codeThe Sbi code of the SbiCode.
descriptionThe Description of the SbiCode.

DutchBusinessSbiCodeV3

sbi_codeThe Sbi code of the SbiCode.
descriptionThe Description of the SbiCode.

DutchBusinessInsolvency

insolvency_idThe identification the insolvency is registered in the insolvency register
eventsA Patterns::{Type}Array of DutchBusinessInsolvencyPublication.  [optional]

DutchBusinessInsolvencyPublication

The data of a publication of an event that occurred for the insolvency (fi. a change in judge or a verdict).

publication_idThe identification number of the event (Dutch: publicatiekenmerk).
descriptionA description of the event that is occured for the insolvency.
dateA DutchBusinessDateV3 entry containing the date of the publication.

DutchBusinessReference

A reference to a business establishment.

dossier_numberThe Chamber of Commerce number, consisting of 8 numbers (e.g., 00123456).
establishment_numberThe unique identifier for this business establishment, consisting of 12 numbers (e.g.  012345678912).  Optional.  Some businesses, mainly foundations (`Stichting`), do not have establishments.  In these instances the establishment_number is not returned.
trade_nameName under which the organisation engages in commercial activity.
establishment_cityCity of the establishment address of the business
establishment_streetStreet of the establishment address of the business
correspondence_cityCity of the correspondence address of the business
correspondence_streetStreet of the correspondence address of the business
indication_economically_activeBoolean 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.

DutchBusinessReferenceV2

A reference to a business establishment.

dossier_numberThe Chamber of Commerce number, consisting of 8 numbers (e.g., 00123456).
establishment_numberThe unique identifier for this business establishment, consisting of 12 numbers (e.g.  012345678912).  Optional.  Some businesses, mainly foundations (`Stichting`), do not have establishments.  In these instances the establishment_number is not returned.
nameThe name of the business that matched the search trade_name parameter (or default: trade_name)
match_typeOne of the Tradename match types that indicates what business name was matched.  [optional]
establishment_cityCity of the establishment address of the business
establishment_streetStreet of the establishment address of the business
correspondence_cityCity of the correspondence address of the business
correspondence_streetStreet of the correspondence address of the business
indication_economically_activeBoolean 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.

DutchBusinessEstablishmentReference

A reference to a business establishment.

dossier_numberThe Chamber of Commerce number, consisting of 8 numbers (e.g., 00123456).
establishment_numberThe unique identifier for this business establishment, consisting of 12 numbers (e.g.  012345678912).  Optional.  Some businesses, mainly foundations (`Stichting`), do not have establishments.  In these instances the establishment_number is not returned.
legal_nameThe organization/business name.
trade_nameThe trade name of the business.
match_typeOne of the Tradename match types that indicates what type of business name was matched.  [optional]
establishment_cityCity of the establishment address of the business
establishment_streetStreet of the establishment address of the business
correspondence_cityCity of the correspondence address of the business
correspondence_streetStreet of the correspondence address of the business
indication_main_establishmentIndication the establishment is the main establishment for that dossier.  Only available for establishments (see establishment_number).

DutchBusinessUpdateSubscription

dossier_numberThe Chamber of Commerce number, consisting of 8 numbers (e.g., 00123456).
establishment_numberThe unique identifier for this business establishment, consisting of 12 numbers (e.g.  012345678912).  Optional.  Some businesses, mainly foundations (`Stichting`), do not have establishments.  In these instances the establishment_number is not returned.
up_to_dateAn indication whether the subscription is up to date
pending_updatesList of updates that have not been retrieved yet

DutchBusinessUpdateReference

Information on the latest update to a business establishment.

dossier_numberThe Chamber of Commerce number, consisting of 8 numbers (e.g., 00123456).
establishment_numberThe unique identifier for this business establishment, consisting of 12 numbers (e.g.  012345678912).  Optional.  Some businesses, mainly foundations (`Stichting`), do not have establishments.  In these instances the establishment_number is not returned.
update_typesA list of update types, see dutchBusinessUpdateGetDossiers for a list of possible types.
date_last_updateThe date on which the dossier was last updated

DutchBusinessVatNumber

dossier_numberThe Chamber of Commerce number, consisting of 8 numbers (e.g., 00123456).
vat_numberThe Value added tax number (dutch: BTW nummer)
date_last_updateThe date on which the data was last validated

DutchBusinessDate

A date.  For some dates, the day and month are unknown.  In that case, they are left empty.

YearThe year of this date.
MonthThe month of this date, 1 for January.  Optional.
DayThe day of this month.  Optional.

DutchBusinessDateV2

yearThe Year of the Date.
monthThe Month of the Date.
dayThe Day of the Date.

DutchBusinessDateV3

yearThe Year of the Date.
monthThe Month of the Date.
dayThe Day of the Date.

DutchBusinessExtractHistory

Information about the extract document base we have gathered.  These business documents are considered up to date untill we have recieved and processed new updates for the business.  Foreach entry within the document history the changes between the document and it’s previous version is logged.

forecastA DutchBusinessExtractChangeForecast entry, containing the difference between the last retrieved document and the current extract document.
referencesA Patterns::{Type}Array of DutchBusinessExtractReference entries, containing a list of extract documents and their changes.  The history can contain at most one entry for a dossier per day.  [optional]

DutchBusinessExtractChangeForecast

Information about the changes that have been logged within our system, between the date the extract document is last retrieved and now.  This gives a indication what data in this document is still relevant.  Because of the update frequency of our database, our forecast can only display changes for documents that are older than (at least) one week.  When a newer extract document is retrieved the forecast is cleared and the original forecast data is moved to the reference history.

change_setA DutchBusinessExtractChangeSet entry, containing the “upcomming” changes.

DutchBusinessExtractReference

Reference to a stored extract document.

extract_idAn unique key that identifies a single document.
document_dateThe date the document was retrieved.
change_setA DutchBusinessExtractChangeSet entry, containing the changes between this extract document and the previous one.

DutchBusinessExtractChangeSet

Information about the changes that have been logged within our system, between a stored extract document and a previous one for that dossier.  The change forecast is based on our database updates, which does not contain updates about business positions.

periodA DutchBusinessPeriod entry, containing the period where the changes on the dossier where made.
changesA list with the parts of the document that are changed.  Can contain:
legal_entitylegal entity (Dutch: rechtspersoon) has changed.
enterpriseenterprise (Dutch: onderneming) has changed.
partnershipthe partnership (Dutch: samenwerkingsverband) has changed.
establishmentsa change in the establishments (Dutch: vestigingen) was made or a new establishment is added.
positionsbusiness positions (Dutch: personen/posities) have changed.

DutchBusinessDossierHistory

Updates that have occured related to a business.

referencesA Patterns::{Type}Array of DutchBusinessDossierReference entries, containing a list of historical dossier updates.

DutchBusinessDossierReference

Reference to the dossier updates that occurred on a specific update date.

update_dateThe date the dossier was updated.
change_setA DutchBusinessChangeSet entry, containing the updates that occured for the business.

DutchBusinessChangeSet

Information about the changes that have been logged within our system for a specific dossier

periodA DutchBusinessPeriod entry, containing the period where the changes on the dossier where made.
changesA list with the parts of the dossier that are changed.  See Update types for a list of available changes.

DutchBusinessPeriod

The period the change set applies to.

start_datePeriod start date.
end_datePeriod end date.

DutchBusinessNewsItem

A news item.

titleThe title ot the item
dateThe date of publication (returned in yyyy-mm-dd hh:mm:ss format)
shortThe first 25 words of the article
urlThe url of the original item
sourceThe source of the item
typeThe type of item
sentimentThe sentiment for the item.  The sentiment is scored between -1 and 1
topicsA list of topics to which the news item is related
companiesA Patterns::{Type}Array of DutchBusinessNewsCompany entries

DutchBusinessNewsCompany

A company related to a news item.

dossier_numberThe Chamber of Commerce number, consisting of 8 numbers (e.g., 00123456).
nameThe company name

DutchBusinessUBOInvestigationToken

A UBO investigation token.  Use this token when calling DutchBusinessUBOInvestigationStatus or DutchBusinessUBOInvestigationResult

tokenThe UBO token

DutchBusinessUBOInvestigationStatus

A status of a given UBO investigation.

statusThe status.  See UBO Investigation statuses for all possible statuses and their meaning
date_sinceThe date of the last change to the status
descriptionA message regarding the current status [optional]

DutchBusinessUBOInvestigationResult

The results of the UBO investigation.

nameThe name of the organization under investigation
dossier_numberThe dossier number of the organization under investigation
personsA Patterns::{Type}Array of DutchBusinessUBOPerson found during the investigation
organisationsA Patterns::{Type}Array of DutchBusinessUBOOrganisation found during the investigation
treeThe tree discovered while performing the investigation.  The first DutchBusinessUBOOrganizationNode always contains the data of the company under investigation, with owning companies included under `parents`

DutchBusinessUBOOrganizationNode

A business reference found during a UBO investigation

levelThe level of the reference inside the tree
idThe id related to the organisation.  If the organisation type is a `Company`, the key will correspond to a dossier number, which can be found in the DutchBusinessUBOOrganisation list.  If the organisation type is a `Person` the key will be an automatically generated key with which the person can be found inside the DutchBusinessUBOPerson list (note: this key is only usable in the context of this request).  When a the type is `ForeignCompany` the id will be marked as N/A.
typeThe type of the organisation in relation to its child.  Can be either `ForeignCompany`, `Company` or `Person`
role_typeThe role type of the business in relation to its parent [optional]
registered_inIf a foreign company, this field will contain further information on where it is registered Otherwise it is empty [optional]
nameThe business name
parentsA Patterns::{Type}Array of DutchBusinessUBOOrganizationNode with a stake inside the current business

DutchBusinessUBOPerson

A natural person found during a UBO investigation

keyA unique hash key.  Can be used to find persons inside the result tree.  Note that the key is only unique in context of the investigation
first_nameThe first name of the person
middle_namesThe middle names of the person [optional]
last_nameThe last name of the person
genderThe gender of the person.  Might be either MALE, FEMALE or empty [optional]
date_of_birthThe date of birth of the person [optional]
place_of_birthThe place of birth of the person [optional]
country_of_birthThe country of birth of the person [optional]
date_of_deathThe date of death of the person [optional]
rolesA Patterns::{Type}Array of DutchBusinessUBORole associated with this person

DutchBusinessUBORole

A person role found during a UBO investigation

dossier_numberThe dossier number of the business associated with this role.  This number kan be used to look up the business in the DutchBusinessUBOOrganisation listing.
titleThe title of the role
role_typeThe type of role [optional]
competencyInformation on the competency of this person
start_role_dateThe start date of the role [optional]

DutchBusinessUBOOrganisation

An organisation found during a UBO investigation

dossier_numberThe dossier number related to the business
nameThe business name
legal_form_codeRegistered legal form used by the organisation.  See DutchBusinessDossierV3 for the possible codes and texts [optional]
legal_form_textDescription of the legal form (in Dutch) [optional]
cityThe city of the business [optional]
extractA DutchBusinessUBOExtract used during the investigation

DutchBusinessUBOExtract

An extract of a DutchBusinessUBOOrganisation found during a UBO investigation

documentA base64 encoded pdf of the extract
sourceThe base64 encoded source html on which the extract is based
dataA DutchBusinessExtractDocumentData entry.
extract_dateThe extract date when the extract was retrieved

dutchBusinessUBOCostsInvestigationResult

The costs of the UBO investigation.

tokenthe UBO token
statusthe status of the UBO invesigation
receiptDutchBusinessUBOReceipt costs of the investigation
paymentDutchBusinessUBOPayment details of the payment done for the investigation

DutchBusinessUBOReceipt

Breakdown of the costs for a UBO investigation

total_pricetotal price
itemslist of items

DutchBusinessUBOReceiptItem

Breakdown of costs

descriptiondescription of the current item
quantityamount of the current item
unit_priceprice for a single item
total_pricetotal price

DutchBusinessUBOClassificationResult

Result of a UBO classification.  See UBO Classification Types

tokenThe token used
scenarioThe scenario used
suspectsA list of classified suspects

DutchBusinessUBOClassifiedSuspect

A classified suspect

keyA unique hash key.  Can be used to find persons inside the result tree.  Note that the key is only unique in context of the DutchBusinessUBOInvestigationResult
personDutchBusinessUBOClassifiedPerson personal information for the suspect
roleDutchBusinessUBOClassifiedRole role information for the suspect,
classificationThe classification as determined by the scenario.  See UBO Classification Types for more information on the possible types

DutchBusinessUBOClassifiedPerson

The personal information for the classified suspect

first_nameThe suspect first name
last_nameThe suspect last name
date_of_birthThe suspect date of birth (Y-m-d)

DutchBusinessUBOClassifiedRole

The role of the classified suspect

dossier_numberThe dossier number of the organisation
organisation_nameThe organisation name
titleThe suspect title within the organisation
function_typethe suspect function type within the organisation

DutchBusinessUBOPayment

Breakdown of UBO Payment

prepre payment
costactual cost for the investigation
refundthe amount to be refunded

DutchBusinessSBICollection

A DutchBusiness Company SBI Collection.  Divided by source

originalA Patterns::{Type}Array of DutchBusinessSBICode entries provided by the Chamber of Commerce
company_infoA Patterns::{Type}Array of DutchBusinessSBICode provided by Company.info

DutchBusinessAnnualFinancialStatement

A DutchBusiness annual financial statement.

dossier_numberChamber of Commerce number
yearThe year of the financial statement
typeThe document type of the financial statement
ORIGINALThe financial statement as deposited originally (PDF)
STANDARDIZEDThe financial statement in standardized format after processing (XBRL)
documentThe Base64 encoded financial statement document

DutchBusinessGetLeiResult

The result of a dutchBusinessGetLei request

lei_codeThe actual Lei code
business_entityInformation regarding the business
registrationRegistration information regarding the Lei code, a DutchBusinessLeiRegistration entry.

DutchBusinessLeiRegistration

A DutchBusiness LEI registration.  Information regarding the LEI code registration.

last_updateLast modification date of the registration.
statusCurrent status of the registration.
assignment_dateAssignment date of the registration.
renewal_dateRenewal date of the registration.
managing_louIdentifier of the Local Operating Unit that first issues the LEI.
validation_sourcesIf the LEI has been validated and if so, how.

DutchBusinessLeiBusinessEntity

A DutchBusiness Lei business entity, contains information regarding the business itself.

expiration_dateThe date the company ceased to use the Lei code.
expiration_reasonThe reason the company ceased to use the Lei code, can be `DISSOLVED` or `CORPORATE ACTION`.
successorThe optional successor LEI code of the business entity, a DutchBusinessLeiSuccessor entry.
company_nameThe registered company name.
legal_statusThe current legal status, can either be `ACTIVE` or `INACTIVE`.
legal_formThe current legal form code, a DutchBusinessLeiLegalForm entry.
headquarters_addressThe address of the headquarter, a DutchBusinessLeiAddress.
legal_addressThe registered legal address, a DutchBusinessLeiAddress.
registration_authorityAdditional registration information provided by the registration authority, a DutchBusinessLeiRegistrationAuthority entry.

DutchBusinessLeiLegalForm

Legal form information regarding the LEI entity.

legal_form_codeThe legal form code.

DutchBusinessLeiRegistrationAuthority

Additional registration information provided by the registration authority.

dossier_numberThe dossier number of the company.
registration_authority_idThe id of the registration company.

DutchBusinessLeiAddress

A DutchBusiness Lei address.  Contains all available address information

street_and_numberStreet and house number of the address.
cityCity of the address.
postal_codePostal code of the address.
regionRegion of the address.
countryCountry of the address.

DutchBusinessLeiSuccessor

A DutchBusiness Lei successor.  Successor information in case a new LEI has been provided for an entity.

nameThe name of the successor.
lei_codeThe lei code of the successor.

Definitions

Update types

An ‘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 DutchBusinessDossier or DutchBusinessDossierV2 for an explanation of the fields that are referenced here.

ChamberNochamber_number
Legalformlegal_form_code, indication_organisation_code
Nametrade_name_full, trade_name_45, legal_name
EstablishmentAddressestablishment_street, establishment_house_number, establishment_house_number_addition, establishment_postcode, establishment_city
CorrespondenceAddresscorrespondence_street, correspondence_house_number, correspondence_house_number_addition, correspondence_postcode, correspondence_city, correspondence_country
Contacttelephone_number, domain_name, mobile_number
Activityprimary_sbi_code, secondary_sbi_code1, secondary_sbi_code2
Personnelpersonnel, class_personnel, personnel_fulltime, class_personnel_fulltime, personnel_reference_date
FinancialStatusindication_bankruptcy or indication_dip has changed.
Statusindication_economically_active, indication_non_mailing
Branchmain_establishment_number, indication_main_establishment
ImportExportindication_import, indication_export
ContactPersoncontact_title1, contact_title2, contact_initials, contact_prefix, contact_surname, contact_gender
Capitalauthorized_share_capital, authorized_share_capital_currency, paid_up_share_capital, paid_up_share_capital_currency, issued_share_capital, issued_share_capital_currency
SubscriptionDatesfounding_date, continuation_date, establishment_date
RemovedThe dossier has been removed.
NewThe dossier has been added.  Can only be used in the dutchBusinessUpdateGetChangedDossiers method.
Establishmentestablishment_number: the Establishment number has changed.  This occurs when a business without establishments gets one or more establishments.  Use dutchBusinessGetDossier or dutchBusinessGetDossierV2 with only the dossier number parameter to retrieve the establishment number of the newly added main establishment.
RSINrsin_number: the owner/holder(s) identification number (`Rechtspersonen Samenwerkingsverbanden Informatie Nummer`) has changed.
Tradenamestrade_names: the list of alternative trade names has been updated.
SubsidiariesIndicates that one or more establishments are added or removed for a dossier.  Only available in dutchBusinessGetDossierHistory method response.

Tradename match types

The DutchBusinessReferenceV2 contains a match_type field which indicates on what name field the result was found within the response.  The value of the match_type describes the value that is set within the name field.  These values are:

trade_nameThe name matches the trade name of the business
legal_nameThe name matches the legal name
alternative_trade_nameThe name matches one of the alternative trade names
undeterminedThe match_type could not be determined, the trade name is displayed within name.  This can occur in case the result found was matched on other parameters than the trade_name, like the city name.

UBO Investigation statuses

A UBO investigation can progress through a distinct set of steps, denoted by their status.

newnew investigation request has been registered, but has not yet been started
pendingthe investigation is in progress
readythe investigation completed, but the results have not been processed
finishedthe investigation is ready for pickup
expiredthe investigation is no longer available
errorAn error has occurred during the investigation.  See the error message for more information.

Note that when an investigation has been pending for 24 hours or more it will be considered in a state of error and closed.  Any funds reserved for the investigation will be refunded to the account.

UBO Organisation Types

The tree of a DutchBusinessUBOInvestigationResult will contain three types of children.

PersonA natural person.  Further information can be found in the DutchBusinessUBOPerson list.
CompanyA Dutch business or organisation.  Further information can be found in the DutchBusinessUBOOrganisation list.
ForeignCompanyA foreign business or organisation.  Within the context of the investigation this type can not be further traversed.  Any further owning companies or persons for this person will not be shown.

UBO Classification Types

A dutchBusinessUBOClassifyInvestigation classifies the found UBO suspects (Ultimate Beneficiary Owner), according to the rules of the scenario for labelling the found suspects

UBOthis person is the UBO
UBO Suspectthis person is likely the UBO, but there is not enough information to make a definitive decision
UBO Gatewaythis person is most likely to know who the actual UBO is.
Result of a UBO classification.
Find business establishments using a variety of parameters.
A SBI (‘Standaard Bedrijfs Indeling’) code with description
An organisation found during a UBO investigation
Retrieve the Lei code and related information for a business using the Chamber of Commerce number.
A reference to a business establishment.
The results of the UBO investigation.
Classifies natural persons found in a DutchBusinessUBOClassificationResult and tries to resolve the real UBO.
The business update service methods allow you to keep DutchBusiness data up to date at all times.
Information on a business establishment.
Find business establishments for a dossier number.
This function is deprecated use dutchBusinessSearchParametersV2 instead.
Search for business establishments using a known identifier.
Information on a business establishment including information related to finance and structure.
Information on a business establishment including information related to finance and structure.
A DutchBusiness Company SBI Collection.
A structure that shows a page of a specific result type {Type}.
A reference to a business establishment.
Retrieve data on a business establishment.
Retrieve data on a business establishment including information related to finance and structure.
Information about the Corporate Group Relationships aka ‘concernrelaties’ structure of a single business
Detailed information about the Corporate Group Relationships aka ‘concernrelaties’ structure of a single business.
The DutchBusinessReferenceV2 contains a match_type field which indicates on what name field the result was found within the response.
A reference to a business establishment.
Descriptions related to a DutchBusinessSBICode.
A DutchBusiness annual financial statement.
An extract document containing the available Chamber of Commerce data for a business.
An extract docdateRement containing the available Chamber of Commerce data for a business.
Get the data from an extract document containing the available Chamber of Commerce data for a business.
Get an extract document in PDF, containing the available Chamber of Commerce data for a business.
Information about the extract document base we have gathered.
Get a list of historical business-extract references for the given company or organisation collected by Webservices.nl.
Updates that have occured related to a business.
Returns a list of all companies (that have been added to the users follow list) that have been updated since they were last retrieved by the user (the user whose credentials are used to make the call).
Retrieve information on the last change to a company.
Retrieve dossier numbers for all companies that changed since the given date.
Remove a company from the follow list 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.
Information on the latest update to a business establishment.
Add a company to the follow list for which the user (the user whose credentials are used to make the call) wants to receive updates.
A news item.
A UBO investigation token.
Checks the status of an (ongoing) UBO investigation.
Pick up the results of the UBO investigation.
Starts a UBO investigation.
A status of a given UBO investigation.
An extract of a DutchBusinessUBOOrganisation found during a UBO investigation
The costs of the UBO investigation.
A natural person found during a UBO investigation
A UBO investigation can progress through a distinct set of steps, denoted by their status.
The result of a dutchBusinessGetLei request
A date.
An array of type {Type} entries.
Basic information about the Corporate Group Relationships aka ‘concernrelaties’ structure of a Dutch business.
A graph containing the concern structure of a business
A node representing a business
A relation between two businesses
Summarized information from the last annual financial statement.
Information about the structure of the organization.
The money is given in the smallest available units for the currency (EUR -> cents)
The legal entity of the requested dossier (`Rechtspersoon`).
The enterprise (`onderneming`) of the requested dossier.
A partnership of the requested dossier (`samenwerkingsverband`).
A establishment (vestiging) of the dossier, dossier can contain more than one establishment.
A business position can contain data about a person or business that holds a position within the business.
The money is given in the smallest available units for the currency (EUR -> cents)
A SBI section code with description.
The data of a publication of an event that occurred for the insolvency (fi.
Information about the changes that have been logged within our system, between the date the extract document is last retrieved and now.
Reference to a stored extract document.
Information about the changes that have been logged within our system, between a stored extract document and a previous one for that dossier.
The period the change set applies to.
Reference to the dossier updates that occurred on a specific update date.
Information about the changes that have been logged within our system for a specific dossier
A company related to a news item.
A business reference found during a UBO investigation
A person role found during a UBO investigation
Breakdown of the costs for a UBO investigation
Breakdown of UBO Payment
A dutchBusinessUBOClassifyInvestigation classifies the found UBO suspects (Ultimate Beneficiary Owner), according to the rules of the scenario for labelling the found suspects
The personal information for the classified suspect
The role of the classified suspect
A DutchBusiness LEI registration.
A DutchBusiness Lei successor.
Legal form information regarding the LEI entity.
A DutchBusiness Lei address.
Additional registration information provided by the registration authority.
Get a list of logged updates for a specific business dossier.