Send Number Verifier request

HLR (Home Location Register) is a centralized database that contains detailed information about each subscriber of a certain GSM operator’s network.

Number Verifier API allows you to send network queries to HLR to verify a mobile phone number. This will allows obtaining information that the mobile phone number is active and registered in the mobile network in a real time mode.

Single Number Verifier request

To send Number Verifier request, make a request to this URL:

Request parameters:

Request example:

[{
   "msisdn":"85267202829",
   "reference":"sendHLR0407",
   "tariff":9
   "callback_url":"https://somelink.com/hlr"
}]

Response parameters:

If the request is successful, you will receive a response:

{
  "error": "0",
  "id": "12123",
  "price": "0.002",
  "currency": "EUR"
}

Send a synchronous Number Verifier request

The method allows creating a Number Verifier request to check the number and get the verifier result immediately. To send Number Verifier request synchronously, make a request to this URL:

Request parameters:

Request example:

{
   "msisdn":"85267202829",
   "tariff":9
}

Response parameters:

If the request is successful, you will receive a response:

{
   "error":0,
   "errorDescription":"No errors",
   "id":"271811729",
   "reference":null,
   "msisdn":"380505142320",
   "network":null,
   "status":"active",
   "details":null,
   "createdDatetime":null,
   "statusDatetime":null
}

Send bulk Number Verifier

To send Bulk Number Verifier, make a request to this URL:

Request parameters:

The data array of the following structure is passed:

Request example:

[
   {
      "msisdn":"85267202829", 
      "reference":"extid13423now"
      "tariff":9,
      "callback_url":"http://someurl.com/callback/?id=12345"},
   },
   {
      "msisdn":"85267202829", 
      "reference":"extid13425"
      "tariff":9,
      "callback_url":"http://someurl.com/callback/?id=12346"}
   }
]

Response parameters:

If the request is successful, you will receive a response:

{
  "result": [
    {
      "reference": "extid13423now",
      "id": "12345",
      "error": "0",
      "price": "0.002",
      "currency": "EUR"
    },
    {
      "reference": "extid13425",
      "id": "12346",
      "error": "0",
      "price": "0.002",
      "currency": "EUR"
    }
  ],
  "error": "0",
  "totalprice": "0.004",
  "currency": "EUR"
}