Phone response success
The JSON response is a dictionary (object) containing two main keys:
- "Found": an integer indicating the number of addresses found (e.g., 0 or 1),
- "Phones": a list containing one or more address objects.
Each address object is itself a dictionary containing the following keys:
| Key | Description | Type |
|---|---|---|
| Found | Number of results found | INTEGER |
| Phones | List of phone number validation results (only 1) | ARRAY OF OBJECTS |
| IdError | Error identifier code | STRING(2) |
| Ported | Indicates if the number has been ported | STRING(10) |
| InputNumber | Phone number sent as input | STRING(20) |
| Carrier | Current carrier of the phone number | STRING(50) |
| Location | Geographic location (e.g., METROPOLE, DOM-TOM) | STRING(50) |
| OldCarrier | Previous carrier (if the number was ported) | STRING(50) |
| NumberFormatted | Reformatted phone number | STRING(20) |
| Type | Phone number type (MOBILE, FIXE, etc.) | STRING(10) |
Example:
{
"Found": 1,
"Phones": [
{
"IdError": "1",
"Ported": "",
"InputNumber": "06XXX",
"Carrier": "SFR",
"Location": "METROPOLE",
"OldCarrier": "SFR",
"NumberFormatted": "06XXX",
"Type": "MOBILE"
}
]
}
Phone response error
| Error type | Request | Response type |
| Missing “Licence” parameter | https://{SERVER_ADDRESS}/{VERSION}/phonelookup/?Number=XXXXX&Country=FRA&Licenc=XXXX&Activity=Y | {"status": 400, "message": "Missing parameters", "details": "Licence", "error": "bad request"} |
| Empty “Licence” parameter | https://{SERVER_ADDRESS}/{VERSION}/phonelookup/?Number=XXXXX&Country=FRA&Licence=&Activity=Y | {"status": 400, "message": "Licence must be filled", "details": "", "error": "bad request"} |
Related to