The JSON response is a dictionary whose keys are the numbers from 1 to n and where each element is itself a dictionary containing the following keys :
-> If the postal code does not refer to a street or a company :
-
- Request example :
https://{SERVER_ADDRESS}/CP/?CodePostal=75015&Alpha=True&Instance=0&Pays=FRA&Licence={LICENCE_CODE}
- Request example :
| Key | Value | In JSON response for all countries? | Format if in JSON response |
| Province |
Region where the city is located. Type will depend on the country where the search is performed. Ex for USA: State’s 2 letter code will be sent here |
Yes | STRING(50) |
| IDLocalite | Unique code for each city (INSEE code for France) | Yes | STRING(20) |
| Pays | ISO country code | Yes | STRING(3) |
| Instance | Number passed as a parameter during the call and returned in the response | Yes | STRING(3) |
| CodePostal | City Zip Code | Yes | STRING(10) |
| SousLocalite | Additional information on city | Yes | STRING(50) |
| LieuDit | Dependent locality if applicable | Yes | STRING(50) |
| Localite | City name | Yes | STRING(50) |
| Latitude | Latitude code of the centre of the locality | Yes | DECIMAL(18) |
| Longitude | Longitude code of the centre of the locality | Yes | DECIMAL(18) |
| IDVoie | Unique number to designate the street (if not empty it means that the postal code references a street) | Yes | STRING(20) |
| NbNumero | Number of numbers in the street | Yes | STRING(4) |
| Voie | Only if IDVoie is filled | No | STRING(50) |
| Numero | Empty | Yes | Empty |
| ListeNumero | Empty | Yes | STRING(1024) |
| TypeVoie | Empty | Yes | Empty |
| Complement | Additional address information | Yes | STRING(255) |
| Entreprise | Company name | Yes | STRING(255) |
| Cedex | Indicates whether it is a cedex or not (1 = CEDEX, 0 = not CEDEX) | Yes | STRING(1) |