How to integrate our LIVE ENSOADDRESS solution
History
| Date | Version number | Description |
| 28/02/2022 | 1.0 | Version 1 - EnsoB2B API launch |
- Syntax validation
- Address standardization according to current standards
- International validation
- Auto-completion assistance following 1st character entry
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