Number Lookup (HLR)
HLR lookup is a method to determine the current service provider of a mobile subscriber.
POST https://api.vertexsms.com/hlr
Submits the provided msisdn for HLR lookup. If operation is successful - returns HTTP status code 200 OK
Request example:
POST /hlr HTTP/1.1
Host: api.vertexsms.com
Content-Type: application/json
Accept: application/json
X-VertexSMS-Token: eB52vNTPL9fO3rDrx8pYmVnj6nqceHNhnqceHNh
{ “msisdn”: “37069912345”, “callBackUrl”: “http://api.vertexsms.com/hlr_callback?myRequestId=123456” }
Response example:
HTTP/1.1 200 OK
Content-Type: application/json
Cache-control: no-cache
[1203877133]
After an attempt of MSISDN lookup, Vertex server will perform a POST request to your callBackUrl with POST body containing JSON object with HLR data.
Example request (when dlrUrl is set as http://yourserver.com/your_script.php):
POST /your_script.php HTTP/1.1
Host: yourserver.com
Content-Type: application/json
{ “id”: “1203877133”,”error”:”0”, “imsi”:”2460210051600001”, “country”:”LT”, “mcc”:”246”, “mnc”:”021” }
• operatorId - Internal VertexSMS operator identifier. More info
• operator - Operator name
• country - Country code in ISO 3166-1 alpha-2 format