SMS Web Service

SMS

Click here for a complete list of operations.

HLR_Lookup

Use this function to verify if the phone is on and report back to you status of the phone. The user will not see this message. This will deduct 0.5 credits from your account balance.

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /soap/SMS.asmx HTTP/1.1
Host: api.upsidewireless.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://upsidewireless.com/webservice/sms/HLR_Lookup"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <HLR_Lookup xmlns="http://upsidewireless.com/webservice/sms">
      <token>string</token>
      <signature>string</signature>
      <number>string</number>
    </HLR_Lookup>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <HLR_LookupResponse xmlns="http://upsidewireless.com/webservice/sms">
      <HLR_LookupResult>
        <isOk>boolean</isOk>
        <number>string</number>
        <message>string</message>
        <result>
          <status>string</status>
          <number>string</number>
          <IMSI>string</IMSI>
          <MCC>string</MCC>
          <MNC>string</MNC>
          <operatorName>string</operatorName>
          <operatorCountry>string</operatorCountry>
          <MSC>string</MSC>
          <mscOperator>string</mscOperator>
          <mscMCC>string</mscMCC>
          <mscMNC>string</mscMNC>
          <mscCountry>string</mscCountry>
          <mscLocation>string</mscLocation>
          <message>string</message>
          <type>string</type>
        </result>
      </HLR_LookupResult>
    </HLR_LookupResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /soap/SMS.asmx HTTP/1.1
Host: api.upsidewireless.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <HLR_Lookup xmlns="http://upsidewireless.com/webservice/sms">
      <token>string</token>
      <signature>string</signature>
      <number>string</number>
    </HLR_Lookup>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <HLR_LookupResponse xmlns="http://upsidewireless.com/webservice/sms">
      <HLR_LookupResult>
        <isOk>boolean</isOk>
        <number>string</number>
        <message>string</message>
        <result>
          <status>string</status>
          <number>string</number>
          <IMSI>string</IMSI>
          <MCC>string</MCC>
          <MNC>string</MNC>
          <operatorName>string</operatorName>
          <operatorCountry>string</operatorCountry>
          <MSC>string</MSC>
          <mscOperator>string</mscOperator>
          <mscMCC>string</mscMCC>
          <mscMNC>string</mscMNC>
          <mscCountry>string</mscCountry>
          <mscLocation>string</mscLocation>
          <message>string</message>
          <type>string</type>
        </result>
      </HLR_LookupResult>
    </HLR_LookupResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /soap/SMS.asmx/HLR_Lookup?token=string&signature=string&number=string HTTP/1.1
Host: api.upsidewireless.com

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<HLRLookupResult xmlns="http://upsidewireless.com/webservice/sms">
  <isOk>boolean</isOk>
  <number>string</number>
  <message>string</message>
  <result>
    <status>string</status>
    <number>string</number>
    <IMSI>string</IMSI>
    <MCC>string</MCC>
    <MNC>string</MNC>
    <operatorName>string</operatorName>
    <operatorCountry>string</operatorCountry>
    <MSC>string</MSC>
    <mscOperator>string</mscOperator>
    <mscMCC>string</mscMCC>
    <mscMNC>string</mscMNC>
    <mscCountry>string</mscCountry>
    <mscLocation>string</mscLocation>
    <message>string</message>
    <type>string</type>
  </result>
</HLRLookupResult>

HTTP POST

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /soap/SMS.asmx/HLR_Lookup HTTP/1.1
Host: api.upsidewireless.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

token=string&signature=string&number=string

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<HLRLookupResult xmlns="http://upsidewireless.com/webservice/sms">
  <isOk>boolean</isOk>
  <number>string</number>
  <message>string</message>
  <result>
    <status>string</status>
    <number>string</number>
    <IMSI>string</IMSI>
    <MCC>string</MCC>
    <MNC>string</MNC>
    <operatorName>string</operatorName>
    <operatorCountry>string</operatorCountry>
    <MSC>string</MSC>
    <mscOperator>string</mscOperator>
    <mscMCC>string</mscMCC>
    <mscMNC>string</mscMNC>
    <mscCountry>string</mscCountry>
    <mscLocation>string</mscLocation>
    <message>string</message>
    <type>string</type>
  </result>
</HLRLookupResult>

Parameter	Value
token:
signature:
number: