API Reference

Finding Company data

Dotfile integrates with multiple business data sources to find and offer auto-fill information with worldwide coverage.

It allows you to enhance the user experience and improve data consistency by using official data sources.

Get list of available countries

Dotfile provides information about companies on a defined list of countries. Make sure you guide your user with this list. If you want us to cover a new country, contact us.

Search a company

Find any company with the Search Company endpoint using filters: country and name or registration number.

Fetch company data

Once you have found the company you’re looking for, you can fetch more data on the company and get all information available with Dotfile partners data sources. It also includes information on individuals if available such as legal representatives and UBOs information.

Individuals: Merging strategy

When you fetch a company, it’s possible to get the same person as beneficial owners, legal representatives and/or shareholders.

We provide a list of merged individuals in merged_individuals as an array of Individual objects when our merging strategy are respected.

To merge individuals, we compare person names with these transformations:

  1. We use humanparser lib to parse the person full name and extract the first name and the last name without middle name, salutation and suffix.
  2. Transform first name and last name in lowercase
  3. Remove all white-spaces
  4. Remove all dash
  5. Remove all diacritical marks. Eg: léon -> leon
  6. Concatenate first name and last name

Document order

You can order various documents about a company depending on its country. You can retrieve your documents ordered on the Company Object under document_orders property.

Dotfile provides documents from multiple providers, to ensure the document your looking for is available for a company call List available documents

Here is an example of documents you can find and retrieve, many more documents are available per country:

Documents original NameCountryProduct ref
Extrait Pappers🇫🇷 FRcGFwcGVycyxmcl9leHRyYWl0X3BhcHBlcnM=
Avis de situation INSEE🇫🇷 FRcGFwcGVycyxmcl9hdmlzX3NpdHVhdGlvbl9pbnNlZQ==
Extrait INPI🇫🇷 FRcGFwcGVycyxmcl9leHRyYWl0X2lucGk=
Derniers Statuts🇫🇷 FRcGFwcGVycyxmcl9zdGF0dXRz
KBIS🇫🇷 FRCall list available documents for a company to get it
Company Profile (EBR)🇦🇹 ATCall list available documents for a company to get it
Annual accounts🇦🇹 ATCall list available documents for a company to get it
Ondernemingsgegevens/Extended Profile🇧🇪 BECall list available documents for a company to get it
Uittreksel🇳🇱 NLCall list available documents for a company to get it
Annual accounts🇪🇸 ESCall list available documents for a company to get it
Companies House Document🇬🇧 GBCall list available documents for a company to get it
Many moreWorld wide—

Create entities with company data

You can now easily use fetched company data to create Company and individuals objects:

company data integration - Dotfile