This page describes the JSON response returned by the /COMPLV2/ endpoint.
Related Address documentation:
COMPLV2 success response
The JSON response is a dictionary whose keys are numbered from 1 to n. Each element contains additional address information for the selected street number.
Example requests
https://{SERVER_ADDRESS}/COMPLV2/?IDVoie=1456244&IDNum=22&Taille=38&Pays=FRA&Licence={LICENCE_CODE}https://{SERVER_ADDRESS}/COMPLV2/?IDVoie=1751437&IDNum=23&Taille=38&Pays=FRA&Licence={LICENCE_CODE}https://{SERVER_ADDRESS}/COMPLV2/?IDVoie=1357366&IDNum=116&Taille=38&Pays=FRA&Licence={LICENCE_CODE}
| Key | Value | France | International |
|---|---|---|---|
| Batiment | Additional address information if applicable. | STRING(38) | STRING(150) |
| CodePostal | Postal code linked to the additional address information if applicable. | Not available | STRING(10) |
| Longitude | Longitude of the centre of the locality. | DECIMAL(18) | DECIMAL(18) |
| Latitude | Latitude of the centre of the locality. | DECIMAL(18) | DECIMAL(18) |
Additional fields
If your licence includes this option (France only), the following additional fields are returned:
| Key | Value | France | International |
|---|---|---|---|
| Status_IrisIlot | Origin of Iris and Ilot codes. | STRING(5) | N/A |
| ilot | Ilot code. | STRING(9) | N/A |
| iris | Iris code. | STRING(9) | N/A |
Examples
Example without optional fields:
{
"1": {
"Batiment": "CHRISTY VIENER, FL 4",
"CodePostal": "10020-2400"
},
"2": {
"Batiment": "FL 4",
"CodePostal": "10020-2402"
},
"Latitude": "40.758224999999996",
"Longitude": "-73.977428"
}
Example with optional fields:
{
"1": {
"Batiment": "BATIMENT A"
},
"2": {
"Batiment": "BATIMENT B"
},
"iris": "5101",
"ilot": "1330015",
"Longitude": "2.36184219788525",
"Latitude": "48.8190056386452",
"Status_IrisIlot": "INSEE"
}
COMPLV2 error response
| Error type | Request | Response type |
|---|---|---|
Missing Licence parameter |
https://{SERVER_ADDRESS}/COMPLV2/?IDVoie=1456244&IDNum=22&Taille=38&Pays=FRA |
Empty response |
Empty Licence parameter |
https://{SERVER_ADDRESS}/COMPLV2/?IDVoie=1456244&IDNum=22&Taille=38&Pays=FRA&Licence= |
Empty response |
| Incorrect licence number | https://{SERVER_ADDRESS}/COMPLV2/?IDVoie=1456244&IDNum=22&Taille=38&Pays=FRA&Licence={INCORRECT_LICENCE_CODE} |
Empty response |
Missing IDVoie parameter |
https://{SERVER_ADDRESS}/COMPLV2/?IDNum=22&Taille=38&Pays=FRA&Licence={LICENCE_CODE} |
400 Bad Request error |
Missing IDNum parameter |
https://{SERVER_ADDRESS}/COMPLV2/?IDVoie=1456244&Taille=38&Pays=FRA&Licence={LICENCE_CODE} |
400 Bad Request error |
Missing Pays parameter |
https://{SERVER_ADDRESS}/COMPLV2/?IDVoie=1456244&IDNum=22&Taille=38&Licence={LICENCE_CODE} |
400 Bad Request error |
| Error on a parameter | https://{SERVER_ADDRESS}/COMPLV2/?IVoie=1456244&IDNum=22&Taille=38&Pays=FRA&Licence={LICENCE_CODE} |
400 Bad Request error |
Related to