How to integrate our LIVE ENSOADDRESS solution

History

Date Version number Description
28/02/2022 1.0 Version 1 - EnsoB2B API launch
Ensuring the reliability of a postal address requires several levels of qualification and processing in order to guarantee integrated data quality that can be used immediately for your internal purposes. To guarantee this level of reliability, our solution integrates all the following points:

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 EnsoAdresse service must be made to the following URL:

				
					https://api.dataenso.com/address
				
			

ENSOADDRESS API call

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

Field

Status

Type

Example

Comments

Api_key

Required

String

your-api-key

Token generated by Data Enso

addr

Required

String

2 rue huche

Searched address

country    

 

Optional

String

FRA

country code in ISO 3166-1 alpha-3 format

API call response

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

Field

Type

Example

Title

string

92 Avenue de France, 75013 Paris, France

Address

 

 

Label

string

92 Avenue de France, 75013 Paris, France

countrycode

string

FRA

countryname

string

France

statecode

string

IDF

state

string

ÃŽle-de-France

county

string

Paris

city

string

Paris

district

string

13th Arrondissement

street

string

Avenue de France

postalcode

string

75013

housenumber

integer

92

Position

 

 

lat

integer

48.82943

lng

integer

2.37813

Access

 

 

lat

integer

48.82943

lng

integer

2.37813

mapView

 

 

west

integer

2.37676

south

integer

48.82853

east

integer

2.3795

north

integer

48.83033

Example of a Curl method query

				
					https://api.dataenso.com/address/?addr=2+rue+huche\
  -H "api_key: <YOUR-TOKEN>"
				
			

Answer:

				
					{"items":
[
{"title":"2 Rue Huché, 92150 Suresnes, France",
"address":{"label":"2 Rue Huché, 92150 Suresnes, France","countryCode":"FRA","countryName":"France","stateCode":"IDF","state":"Île-de-France","county":"Hauts-de-Seine","city":"Suresnes","street":"Rue Huché","postalCode":"92150","houseNumber":"2"},
"position":{"lat":48.87574,"lng":2.22063},
"access":[{"lat":48.87576,"lng":2.22059}],
"mapView":{"west":2.21926,"south":48.87484,"east":2.222,"north":48.87664},

{"title":"2 Rue de la Huche, 06520 Grasse, France",
"address":{"label":"2 Rue de la Huche, 06520 Grasse, France","countryCode":"FRA","countryName":"France","stateCode":"PAC","state":"Provence-Alpes-Côte d'Azur","county":"Alpes-Maritimes","city":"Grasse","district":"Magagnosc","street":"Rue de la Huche","postalCode":"06520","houseNumber":"2"},
"position":{"lat":43.68065,"lng":6.96125},
"access":[{"lat":43.68064,"lng":6.96126}],
"mapView":{"west":6.96001,"south":43.67975,"east":6.96249,"north":43.68155},
]}

				
			

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

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.