API - Description - Address - COMPLV2 - Response

Support DQE
Support DQE
  • Updated

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

Was this article helpful?

0 out of 0 found this helpful