HLRLookupBulk

Returns details about the carrier of the given North American phone numbers.

Available only on our API 2 and API 3 Plans.

JavaScript | Node.js

// uses JQuery library
var postUrl = "https://secure.smsgateway.ca/services/message.svc/"
  "HLRLookupBulk/" + accountKey;
var body = JSON.stringify({
  phoneNumbers: [destinationNumber, destinationNumber, ...]
});
$.ajax({
    url: postUrl,
    method: "POST",
    contentType: "application/json;charset=UTF-8",
    data: body
}).done(function(response) {
  alert(response);
}).error(function (xhr, textStatus, errorThrown) {
  alert (xhr.responseText);
});

php

<?php
// using SOAP Module - http://ca3.php.net/soap

class SMSParam {
    public $AccountKey;
    public $PhoneNumbers;
}

$client = new SoapClient('https://secure.smsgateway.ca/sendsms.asmx?WSDL');
$parameters = new SMSParam;

$parameters -> AccountKey = accountKey;
$parameters -> PhoneNumbers = (destinationNumber, destinationNumber, ...);

$Result = $client->HLRLookupBulk($parameters);
?>

vb.net

' Service Reference (SOAP)
Using client = New SwiftSMS.SendSMSSoapClient
    Dim response = client.HLRLookupBulk(accountKey, phoneNumbers)
End Using

Dim url = String.Format("https://secure.smsgateway.ca/services/message.svc//HLRLookupBulk/{0}",
                        accountKey)
Dim body = "{""PhoneNumbers"": [" & _
    """5552125555"", ""5553135555"", ..." & _
    "]}"

Using wClient = New Net.WebClient
    wClient.Encoding = New UTF8Encoding()
    wClient.Headers.Add(HttpRequestHeader.ContentType, "application/json")

    Dim wResponse = wClient.UploadString(url, body)
End Using

cURL

HTTP POST:
curl -H "Content-Type: application/json" -X POST \
     "https://secure.smsgateway.ca/services/message.svc/HLRLookupBulk/[accountKey]" \
     --data "{\"PhoneNumbers\": [\"destinationNumber\", ...]}"

C#

// Service Reference / SOAP
var phoneNumbers = new SwiftSecure.ArrayOfString { "5552125555", "5553135555" };

using (var client = new SwiftSecure.SendSMSSoapClient())
{
    var numberInfo = client.HLRLookupBulk(accountKey, phoneNumber);
}

// Web Client / REST
dynamic body = new ExpandoObject();
body.phoneNumbers = new[] { "5552125555", "5553135555" };

var url = string.Format("https://secure.smsgateway.ca/services/message.svc/HLRLookupBulk/{0}",
    accountKey);

using (var wClient = new System.Net.WebClient())
{
    wClient.Encoding = Encoding.UTF8;
    wClient.Headers.Add(HttpRequestHeader.ContentType, "application/json");

    var numberInfo = wClient.UploadString(url,
        Newtonsoft.Json.JsonConvert.SerializeObject(body));
}

HTTP Request

POST:

/services/message.svc/HLRLookupBulk/:accountKey

Parameter	Description	Location
AccountKey	Your Swift SMS Gateway account key	URL
phoneNumbers	Array of phone numbers to perform a HLR lookup on	URL