Contact us

EnsoBtoB API documentation

How to integrate our LIVE ENSOB2B solution

History 

Date

Version number

Description

28/02/2022

1.0

Version 1 - EnsoB2B API launch

10/05/2022

1.1

Version 1.1 - Endpoint Autosuggest integration

17/05/2022

1.2

Version 1.2 - Endpoint Autosuggest_zip integration

26/08/2022

1.3

Version 1.3 - IsActive field added

The EnsoB2B solution provides you with all the company data you need to quickly complete your prospects' profiles with consolidated and verified data from the company directories available in the countries covered.

  • Real-time verification of a company's existence
  • Enterprise data recovery (synchronous or asynchronous)
  • International data standardization
  • A search engine tailored to your needs

Authentication

In order to access our services, it is essential to authenticate via a unique secure key (or token) provided by Data Enso. Your token must be integrated into the header under the "api_key" parameter and present for each call to the EnsoPhone API.

Calls to servers

Calls to the EnsoB2B service must be made to the following URL:

				
					https://api.dataenso.com/b2b

Call the ENSOB2B SEARCH API 

Integrated into online forms, this service enables asynchronous enrichment of company information via a reduced data pair.

The URL for this endpoint is : https://api.dataenso.com/b2b/

In order to retrieve company information in real time and obtain reliable results, here is the list of fields required to compose your search

Field Status Type Example Comments
Api_key Required String your-api-key Token generated by Data Enso
Name Required String Fermatic Company name
country Optional String FRA country code in ISO 3166-1 alpha-3 format
ZIP Optional Integer 92160 Postal code of the company you are looking for

ENSOB2B SEARCH API call response

Once you've made the call to our services, here are the fields available in return

Field

Type

Example

Comments

DUNSNumber

String

26XXXXX78

9-digit number assigned by D&B entreprise.

CompanyName

String

FERMATIC SAS

Official company name

CompanySecondaryName

String

FERMATIC

Secondary name, trade name or company brand, if applicable.

AddressStreetLine1

String

ROUTE NATIONALE 190

Company address

AddressStreetLine2

String

RUE DE MANTES

Additional address

PostalCode

String

78440

Company postal code

City

String

GUITRANCOURT

Company location

StateProvince

String

YVELINES

Name of state, company department

Country

String

FRANCE

Company country

NationalId

String

79XXXXXXX00019

Company identification number (SIRET, CNPJ,KWK...)

SICCode

String

1796

standard industrial classification code that categorizes companies by type of activity

Industry

String

C

SIC division code

Activity

String

 

Main business sector

EstablishmentOfOwnership

String

2013

Company creation date

SalesEUR

Double

12060819

Previous year's sales

EmployeesNumber

String

50

Number of company employees

IsActive

String

A

Indicates whether the company is active (A) or has ceased trading (C)

EnsoId

String

H-FR01XXXXX230

Unique company identifier

Example of an ENSOB2B SEARCH query

				
					https://api.dataenso.com/b2b/?name=ferma&zip=78440&country=FRA \
-h "api_key:your-token"

Answer:

				
					[
    {
        "DUNSNumber": "26XXXXX78",
        "CompanyName": "FERMATIC SAS",
        "CompanySecondaryName": "",
        "AddressStreetLine1": "ROUTE NATIONALE 190",
        "AddressStreetLine2": "RUE DE MANTES",
        "PostalCode": "78440",
        "City": "GUITRANCOURT",
        "StateProvince": "YVELINES",
        "Country": "FRANCE",
        "NationalId": "79XXXXXXX00019",
        "SICCode": "1796",
        "Industry": "C",
        "EstablishmentOfOwnership": 2013,
        "SalesEUR": 1XXXXX19,
        "EmployeesNumber": 50
        "IsActive": "A",
        "EnsoId": "123456789",
    }
]

PS: to reduce the list of available answers ("strict" search), we recommend adding "double quotes" before and after the search term in the name field:

Ex: https://api.dataenso.com/b2b/?name= " fermatic "&country=FRA&zip=78440

Call the ENSOB2B SUGGEST API without Postal Code parameters

This Endpoint is dedicated to the use of suggestion, semi-automatic company entry in online forms (usually integrated in a drop-down list of choices).

It's optimized for company searches using only the company name.

The URL for this specific endpoint is as follows: https://api.dataenso.com/b2bsuggest/

Field

Status

Type

Example

Comments

Api_key

Required

String

your-api-key

Token generated by Data Enso

name

Required

String

Fermatic

Company name

country    

 

Required

String

FRA

country code in ISO 3166-1 alpha-3 format

Response to ENSOB2B SUGGEST API call without Postal Code parameter

After making the call to this dedicated service, here are the fields available in return:

Field

Type

Example

Comments

CompanyName

String

SYND COPR DU 4 6 RUE FERMAT 75014 PARIS

Official company name

PostalCode

String

75014

Company postal code

StateProvince

String

PARIS

Name of state, company department

NationalId

String

039XXXXXXXX015

Company identification number (SIRET, KWK...)

IsActive

String

A

Indicates whether the company is active (A) or has ceased trading (C)

EnsoId

String

H-FR01XXXXX230

Unique company identifier

 

Example of ENSOB2B SUGGEST query without Postal Code parameter

				
					https://api.dataenso.com/b2bsuggest/?name=ferma&country=FRA \
-h "api_key:your-token"

Answer:

				
					[
    {
        "CompanyName": "FERMATIC SAS",
        "PostalCode": "78440",
        "StateProvince": "YVELINES",
        "NationalId": "79XXXXXXXXX019"
        "IsActive": "A",
        "EnsoId": "H-FR0024293040",

    },
    {
        "CompanyName": "FERMATIC AGENCE NORMANDIE",
        "PostalCode": "76160",
        "StateProvince": "SEINE MARITIME",
        "NationalId": "33XXXXXXXXX042"
        "IsActive": "A",
        "EnsoId": "H-FR0089886615",

    },
{
        "CompanyName": "SYND COPR DU 4 6 RUE FERMAT 75014 PARIS",
        "PostalCode": "75014",
        "StateProvince": "PARIS",
        "NationalId": "03XXXXXXXXX015"
                "IsActive": "A",
                "EnsoId": "H-FR0100703230",

    },
]

Call the ENSOB2B SUGGEST API with Postal Code parameters

This second endpoint is dedicated to auto-suggestion, and when the value is present in the form, enables a geolocalized search of the company by zip code.

The URL for this specific endpoint is as follows: https://api.dataenso.com/b2bsuggest_zipcode/

Field

Status

Type

Example

Comments

Api_key

Required

String

your-api-key

Token generated by Data Enso

name

Required

String

Fermatic

Company name

country   

Required

String

FRA

country code in ISO 3166-1 alpha-3 format

zip

Required

Integer

92160

Postal code of the company you are looking for

Response to ENSOB2B SUGGEST API call with Postal Code parameter

Once you have made the call to our services, here are the fields available in return:

Field

Type

Example

Comments

CompanyName

String

FERMATIC SAS

Official company name

CompanySecondaryName

String

FERMATIC

Secondary name, trade name

AddressStreetLine1

String

ROUTE NATIONALE 190

Company address

AddressStreetLine2

String

RUE DE MANTES

Additional address

PostalCode

String

78440

Company postal code

City

String

GUITRANCOURT

Company location

IsActive

String

A

Indicates whether the company is active (A) or has ceased trading (C)

EnsoId

String

H-FR01XXXXX230

Unique company identifier

Example of ENSOB2B SUGGEST query with Postcode parameter

				
					https://api.dataenso.com/b2bsuggest_zipcode/?name=data&zip=92150&country=FRA \
-h "api_key:your-token"

Answer:

				
					Champ	Type	Exemple	Commentaires
EnsoId	Integer	H-123456789	Identifiant unique de la société
E_DUNSNumber	Integer	26XXXXX78	Numéro à 9 chiffres attribué par D&B entreprise.
E_CompanyName	String	FERMATIC SAS	Nom officiel de l’entreprise
E_CompanySecondaryName	String	FERMATIC	Nom secondaire, nom commercial ou marque de l»entreprise, le cas échéant.
E_AddressStreetLine1	String	ROUTE NATIONALE 190	Adresse de l’entreprise
E_AddressStreetLine2	String	RUE DE MANTES	Complément d’adresse
E_PostalCode	String	78440	Code postal de l’entreprise
E_City	String	GUITRANCOURT	Ville où se situe l’entreprise
E_StateProvince	String	YVELINES	Nom de l’état, du département de l’entreprise
E_Country	String	FRANCE	Pays de l’entreprise
E_NationalId	String	79XXXXXXX00019	Numéro d’identification de l’entreprise (SIRET, CNPJ,KWK…)
E_NationalIdType	String	France SIRET Number	Source du National ID
E_IsActive	String	A	Indique si la société est active (A) ou activité est cessée (C)
E_SICText	String	Building equipment installation	Activité de la société dans la nomenclature internationale SIC
E_SICCode	String	1796	Code de classification industrielle standard qui catégorise les entreprises selon le type d’activité
E_Industry	String	C	Code de la division SIC
E_LocalActivityCode	Integer	4329B	Ce code représente le code d’activité utilisé localement. Exemples
incluent 1972 U.S. SIC, SBA, APE et NACE.
E_Activity	String		Secteur d’activité principal
E_EstablishmentOfOwnership	String	2013	Date de création de l’entreprise
E_last_year_turn_over	Double	12060819	Chiffre d’affaires de l’année précédente
E_last_year_turn_over_validity	Integer		
E_Employees	Integer	50	Le nombre d’employés dans l’entreprise.
E_Employees_Number_validity	string	0	Valeur qui décrit la fiabilité du nombre d’employés.
0 - réel
1 - peu fiable
2 - estimé ou non disponible lorsque le nombre d’employés
est zéro
3 - modélisé
vide - non disponible lorsque le champ E_Employees est égal à 0 ou est inconnu.
E_Employees_Number_Local	Integer	50	Le nombre d’employés à cette adresse.
E_Employees_Local_validity	string	0	Valeur qui décrit la fiabilité du nombre d’employés à cet endroit.
0 - réel
1 - peu fiable
2 - estimé ou non disponible lorsque le nombre d’employés
est zéro
3 - modélisé
vide - non disponible lorsque E_Employees_Number_Local est égal à 0 ou est inconnu.
E_Employees_Total	Integer	76	Le nombre total d’employés dans l’entreprise
E_Employees_Total_Validity	string	0	Valeur qui décrit la fiabilité du nombre d’employés à cet endroit.
0 - réel
1 - peu fiable
2 - estimé ou non disponible lorsque le nombre d’employés
est zéro
3 - modélisé
vide - non disponible lorsque E_Employees_Total est égal à 0 ou est inconnu.
E_Company_Type	String	private limited company		Statut juridique de la société
E_Location_Type	Integer	0	Ce code indique si l’entreprise est :
0 = unique - aucune autre entité ne lui rend compte
1 = Siège social/Parent : des succursales et/ou filiales rapportent à cette structure
2 = Succursale : emplacement secondaire à un siège social
Le code est vide lorsqu’il n’est pas disponible.
E_Websites	String	www.fermatic.fr	Liste de tous les sites web associés à la société
E_Website	String	www.fermatic.fr	Site web principal de la société

Call the ENSOB2B COMPANY DETAILS API

In order to retrieve additional information, an additional query must be performed, requesting the company's EnsoId number (information available in the results of the SEARCH or SUGGEST query).

Calls to the EnsoB2B DETAILS service should be made to the following url: https: //api.dataenso.com/b2bdetail/

Field

Status

Type

Example

Comments

Api_key

Required

String

your-api-key

Token generated by Data Enso

EnsoId

Required

Integer

H-123456789

Identifier of the company searched in the Enso Search call

ENSOB2B COMPANY API call response DETAILS

Once you have made the call to our services, here are the fields available in return:

Field

Type

Example

Comments

EnsoId

Integer

H-123456789

Unique company identifier

E_DUNSNumber

Integer

26XXXXX78

9-digit number assigned by D&B entreprise.

E_CompanyName

String

FERMATIC SAS

Official company name

E_CompanySecondaryName

String

FERMATIC

Secondary name, trade name or company brand, if applicable.

E_AddressStreetLine1

String

ROUTE NATIONALE 190

Company address

E_AddressStreetLine2

String

RUE DE MANTES

Additional address

E_PostalCode

String

78440

Company postal code

E_City

String

GUITRANCOURT

Company location

E_StateProvince

String

YVELINES

Name of state, company department

E_Country

String

FRANCE

Company country

E_NationalId

String

79XXXXXXX00019

Company identification number (SIRET, CNPJ,KWK...)

E_NationalIdType

String

France SIRET Number

National ID source

E_SICText

String

Building equipment installation

Company activity in the international SIC nomenclature

E_SICCode

String

1796

Standard industrial classification code that categorizes companies by type of activity.

E_Industry

String

C

SIC division code

E_LocalActivityCode

Integer

4329B

This code represents the activity code used locally. Examples

includes 1972 U.S. SIC, SBA, APE and NACE.

E_Activity

String

 

Main business sector

E_EstablishmentOfOwnership

String

2013

Company creation date

E_last_year_turn_over

Double

12060819

Previous year's sales

E_last_year_turn_over_validity

Integer

 

 

E_Employees

Integer

50

Number of employees.

E_Employees_Number_validity

string

0

Value describing the reliability of the number of employees.

0 - real

1 - unreliable

2 - estimated or not available when number of employees

is zero

3 - modeled

empty - not available when E_Employees is 0 or unknown.

E_Employees_Local_Number

Integer

50

The number of employees at this address.

E_Employees_Local_validity

string

0

Value describing the reliability of the number of employees at this location.

0 - real

1 - unreliable

2 - estimated or not available when number of employees

is zero

3 - modeled

empty - not available when E_Employees_Number_Local is 0 or unknown.

E_Employees_Total

Integer

76

Total number of employees in the company

E_Employees_Total_Validity

string

0

Value describing the reliability of the number of employees at this location.

0 - real

1 - unreliable

2 - estimated or not available when number of employees

is zero

3 - modeled

empty - not available when E_Employees_Total is 0 or unknown.

E_Company_Type

String

private limited company        

Company legal status

E_Location_Type

Integer

0

This code indicates whether the company is :

0 = unique - no other entity reports to it

1 = Head office/Parent: branches and/or subsidiaries report to this structure

2 = Branch: secondary location to a head office

The code is empty when not available.

E_Websites

String

www.fermatic.fr

List of all websites associated with the company

E_Website

String

www.fermatic.fr

Main company website

Example query COMPANY DETAILS

Answer:

				
					https://api.dataenso.com/ /b2bdetail/?EnsoId=H-FR0024293040
-h "api_key:your-token"
				
			
				
					[EnsoId: «H-FR0024293040»,
  E_DUNSNumber: «264995778»,
  E_CompanyName: «FERMATIC SAS»,
  E_CompanySecondaryName: « »,
  E_AddressStreetLine1: «ROUTE NATIONALE 190»,
  E_AddressStreetLine2: «RUE DE MANTES»,
  E_PostalCode: «78440»,
  E_City: «GUITRANCOURT»,
  E_StateProvince: «YVELINES»,
  E_Country: «FRANCE»,
  E_NationalId: «79219347600019»,
  E_NationalIdType: «France SIRET Number»,
  E_Isactive : «A»,
  E_SICText: «Building equipment installation»,
  E_SICCode: «1796»,
  E_Industry: «C»,
  E_Local_Activity_Code: «4329B»,
  E_Local_Activity_Code_repository: "NAF2 (NOMENCLATURE D»ACTIVITE FRANCAISE ver 2)",
  E_EstablishmentOfOwnership: 2013,
  E_last_year_turn_over: 12060819,
  E_last_year_turn_over_validity: «0»,
  E_Employees: 50,
  E_Employees_Number_validity: «0»,
  E_Employees_Number_Local: 50,
  E_Employees_Local_validity: «0»,
  E_Employees_Total: 67,
  E_Employees_Total_Validity: «0»,
  E_Company_Type: «corporation»,
  E_Location_Type: 1,
  E_Websites: [ «www.fermatic.fr» ],
  E_Website: «www.fermatic.fr»
}
]

To receive our various API Docs by e-mail, please fill in the form below

The Data Quality Blog

Contact

+33 (0)1 47 72 79 61

Make an appointment
Newsletters
Please enable JavaScript in your browser to complete this form.
close menu icon
Stay informed
Receive monthly data tips to improve your e-commerce, CRM, BtoB, marketing and sales performance...
Please enable JavaScript in your browser to complete this form.