Mobile Number Verification (HLR Lookup)

Mobile Number Verification is an HLR Lookup (Home Location Register) service that allows you to check the existence of a mobile phone number and obtain information such as the telecommunications operator to which it is associated.

The service performs an initial lookup and HLR (Home Location Register) check on the mobile network, identifies the formats of mobile numbers, and then enriches the information, such as the status of the SIM (active, blocked, suspended) and any operator change.

The service is available in 56 countries and with more than 260 operators.

REQUEST EXAMPLE

POST /mobile-start/{mobile-phone-number}

To use the service, simply make a POST request to the /mobile-start/{mobile-phone-number} endpoint, passing the mobile number to be verified as a parameter. The number must always be preceded by the international prefix (e.g., +39).

POST /mobile-start/+393331234567

When making the request, it is possible and always recommended to set a callback to receive a notification when the response is available.

{
  "callback": {
    "url": "https://your-server.site/123232",
    "custom": 123
  }
}

RESPONSE EXAMPLE

POST /mobile-start/{mobile-phone-number}

The response is usually returned within seconds and includes information such as:

{
  "data": {
    "isPossible": true,
    "isValid": true,
    "regionCode": "IT",
    "isValidNumberForRegion": true,
    "numberType": "MOBILE",
    "requestedNumber": "00393332114474",
    "formattedNumber": "+393332114474",
    "createdAt": "2024-09-06T13:56:19+00:00",
    "updatedAt": "2024-09-06T13:56:19+00:00",
    "state": "DONE",
    "network": "MNO - Vodafone Italy",
    "originalNetwork": "MNO - TIM (Telecom Italia SpA)",
    "roaming": false,
    "ported": true,
    "country": "Italy",
    "countryPrefix": "39",
    "details": "DELIVERED_TO_HANDSET",
    "id": "66db0a03e8ba8710290e3c0f"
  },
  "success": true,
  "message": "",
  "error": null
}

If it is not possible to process it within the first 10 seconds, a partial response will be returned with status NEW and the ID to handle the request asynchronously.

{
  "data": {
    "isPossible": true,
    "isValid": true,
    "regionCode": "IT",
    "isValidNumberForRegion": true,
    "numberType": "MOBILE",
    "requestedNumber": "00393332114474",
    "formattedNumber": "+393332114474",
    "createdAt": "2024-09-06T13:56:19+00:00",
    "updatedAt": "2024-09-06T13:56:19+00:00",
    "state": "NEW",
    "network": "",
    "originalNetwork": "",
    "roaming":,
    "ported":,
    "country": "",
    "countryPrefix": "",
    "details": "",
    "id": "66db0a03e8ba8710290e3c0f"
  },
  "success": true,
  "message": "",
  "error": null
}

In this case, it will be necessary to make a second call to obtain the required data.

REQUEST EXAMPLE

GET /mobile-start/{id}

The endpoint to check the request status is /mobile-start/{id}, and the method used is GET. If a callback is implemented, you will be notified when your request is fulfilled and your data is available.

This is an example request with the ID obtained in the previous POST call.

GET /mobile-start/66db0a03e8ba8710290e3c0f

The response, if the status is DONE, will return the same data as indicated in the previous POST response.

Mobile number verification is a crucial tool for all companies that send SMS communications or tech companies that develop solutions with this functionality, such as SMS platforms, CRMs, and Ecommerce.

Indeed, the service allows you to validate existing numbers and clean up databases from inactive contacts, optimizing the effectiveness of campaigns and communications at a highly competitive cost.