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

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

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

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

To use the service, simply make a POST request to the endpoint /mobile-start/{mobile-phone-number} passing the mobile number you want to verify 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 recommended to set up a callback to receive a notification when the response is available.

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

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

The response is typically returned in a few seconds and includes information such as:

• mobile number validity
• country code
• country
• number validity for the country
• number type (in our case, it will always be mobile)
• entered number
• formatted number
• request date and time
• update date
• request status (NEW, WAIT, DONE)
• original operator
• current operator
• roaming
• ported (i.e., operator change with the same number)
• country prefix of the mobile number
• details
• request ID

{
  "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 the request within the first 10 seconds, a partial response will be returned, with a NEW status and an ID to manage 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, you will need to make a second call to retrieve the requested data.

EXAMPLE REQUEST
GET /mobile-start/{id}

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

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

GET  /mobile-start/66db0a03e8ba8710290e3c0f. 

The response, when DONE, meaning the request is fulfilled, will return the data already indicated in the previous POST request response.

Mobile number verification is an essential tool for all companies that send communications via SMS or for tech companies that develop solutions with this feature, such as SMS platforms, CRM, or Ecommerce.

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