Bulk SMS Gateway API: Integrate Text Messaging Into Your Applications!

Connect to SMSHat’s Bulk SMS Gateway using our HTTP SMS API. SMSHat’s Bulk SMS Gateway API allows application developers to send text messages to more than 650 global mobile networks. You can integrate bulk SMS messaging services into your applications, websites, software and back-office custom apps. With our HTTP SMS API, it’s quick and easy. If you don’t want to spend time and money writing code, use our ready-made SMS scripts for FREE. The scripts are available in PHP, ASP, VB.Net and C#.Net.

Scroll Down To Check API Links!!!

The Benefits of SMSHat’s Bulk SMS Gateway API:

Our API (Application Programming Interface) makes it easy and cost-effective to integrate bulk SMS messaging into your applications. It offers:

SMS to multiple mobile numbers in one Go : Our SMS API allows you sending SMS to multiple mobile numbers in one single call/request. You can do this by passing comma separated numbers to the mobilenumber parameter.
Communication via SMS in any language : Our SMS server supports standard GSM character set and Unicode characters, so you can send and receive text messages in English, German, Arabic, Russian, Japanese, Chinese and more.
Support for FlashSMS : You can send flash messages using the API. The messages will get delivered to end user mobile as a flash and will not be stored unlike normal messages
Send WAP Push URL messages : Send your direct application download link or your mobile site link to your users using our WAP URL Push supported API. The clickable link will be delivered to recipient mobile.
Custom/Dynamic sender IDs : When sending texts via our HTTP SMS API, you can display any of your registered mobile numbers/senderids as the sending number, use your own mobile phone number, or use a sender ID, such as your company name. Note: Which ever senderid you submit via API must be registered and active in your account.
Delivery rate tracking of your SMS : You can request delivery notifications of all sent messages. All mobile phones return delivery notifications and you can get them via our SMS Gateway web interface.
Fully documented API Manual : Below is complete API details also you will find sample codes for different programming languages on this page.

No Installations required

Just use our ready-made scripts and send thousands of SMS from your application in seconds.

API Sample Interface

Click here to view sample interface created using API..

Ready-Made Scripts

Please choose your coding language and start building your very own SMS application using our sample codes.

XML API

Here is the XML API details available View

SMSHat’s SMS API Formats:

API for Arabic + English (AnyLanguage/Unicode/Language/Non-English) Message text

API For sending SMS in Multi-Language text (English or Non-English or Arabic or Mix, 1 to 10 numbers only in each API request) :-

http://cloud.smshat.com/API_SendLanguageSMS_2020.aspx? User=demo&passwd=demo&mobilenumber=xxxxxxxxxxxx&message=Welcomeأهلابكالإمارات&sid=Test&mtype=OL&key=GeneratedAPIKeyHere

API For sending SMS in Multi-Language text in Unicode form (Non-English/Arabic/Unicode, 1 to 10 numbers only in each API request) :-

http://cloud.smshat.com/API_SendSMS.aspx? User=demo&passwd=demo&mobilenumber=xxxxxxxxxxxx&message=062A06450020062A0633062C064A06440643002006280646 &sid=Test&mtype=OL&key=GeneratedAPIKeyHere
(Click here to test)
Note : message=<Unicode converted value of actual message>
Message needs to be converted to unicode (Big-Endian UCS-2) before passing to the API. Ex : Unicode for arabic character beh ب is 0628, please refer the following unicode chart.

API For sending thousands of SMS (For Arabic/Unicode message, 1 to 50,000 mobile numbers in each request):-

http://cloud.smshat.com/API_SendBulkSMS.aspx?User=demo&passwd=demo&mobilenumber=xxxxxxxxxxxx,xxxxxxxxxxxx,xxxxxxxxxxxx&message=062A06450020062A0633062C064A06440643002006280646 &sid=Test&mtype=OL&key=GeneratedAPIKeyHere
Note :
message=<Unicode converted value of actual message>
Message needs to be converted to unicode (Big-Endian UCS-2) before passing to the API. Ex : Unicode for arabic character beh ب is 0628, please refer the following unicode chart.

Number of characters & SMS Credit & Billing

1SMS Credit = 160 English text Characters, where as 1SMS Credit = 70 Arabic/(Non-English) text characters.
We support unlimited characters of long message both in English and Other Language like Arabic, Hindi, Urdu, Telugu, Malayalam Language ... etc
If the message is long each English message credit/part will be of 153 and Arabic will be of 67 characters, this is just for information, as a developer you can submit the whole message in one single API request.
2SMS Credit = (161 to 306) English Characters, where as 2SMS Credit = (71 to 134) Arabic text characters.
3SMS Credit = (307 to 459) English, where as 3SMS Credit = (135 to 201) Arabic. and so on..

For Amount based billing you will be charged (price-per-sms * 3) in case your message length is between 307 to 459 characters including space and any other valid special characters. Similarly for Arabic/Chinese/Unicode/Non-English it will cost you (price-per-sms * 2) for message length upto 134 characters.. and so on.

SMS API Parameter Details:

ParameterName	Type	Value	Example	Discription
User	String	DemoAccount	User=DemoAccount	Your SMS Account Username, its case sensitive
passwd	String	Demo@AccP@swd	passwd=Demo@AccP@swd	Account password or API password, you can navigate to My Account and set/update API Password, case sensitive
mobilenumber	String	971000000000	mobilenumber=971000000000	Destination mobile number on which you want to send SMS message, multiple numbers can be separated with comma
message	String	Order confirmed!	message=Order confirmed!	English Message Message content here, it need URL Encode to make sure special characters like space etc reach our server well Non-English(Arabic) Text message=<Unicode converted value of actual message> Message needs to be converted to unicode (Big-Endian UCS-2) before passing to the API.
sid	String	YourBrand	sid=YourBrand	Senderid can be max 11 mix of alpha numberic characters, for most of the countries sid need registration with NOC and documents, more details contact support
mtype	String	N / OL	mtype=N for English mtype=OL for unicode	Message Type parameter should be mtype=N for English message, for non-English content pass mtype=OL
key	String	AKYYDNxe39276151827	key=AKYYDNxe39276151827	API Key you can generate navigating to "My Account" section and click on "Get API Key"

Unicode Converter : Convert any language to unicode value

Arabic To Unicode Conversion Scripts :

Javascript Code

Below is the javascript code to convert non english characters to unicode.

var unicodestring = convertCP2UTF16(convertChar2CP(PassNonEnglishMsgHere))

VB Script
Below is the VB code to identify non-English character. For CharPosition = 1 To Len(SMSMessageText) If AscW(Mid(SMSMessageText, CharPosition, 1)) > 255 Then IsItNonEnglish = True Exit For End If Next	Below is the VB code to convert text/string to unicode value. Function constructStringToUnicode(ByVal StringMsgText As String) As String Dim i As Integer, strRetVal As String, strTemp As String On Error GoTo ErrorHandler If Trim("" & StringMsgText) = "" Then StringMsgText = Space(1) For i = 1 To Len(StringMsgText) strTemp = "0000" & Hex(AscW(Mid(StringMsgText, i, 1))) strRetVal = strRetVal & Mid(strTemp, Len(strTemp) - 3) Next constructStringToUnicode = strRetVal ErrorHandler: If Err <> 0 Then constructStringToUnicode = "Error In constructStringToUnicode Function : " & Err.Description End If End Function
C# Script
C# code to findout Unicode for (int CharPosition = 1, loopTo = Len(SMSMessageText); CharPosition <= loopTo; CharPosition++) { if (AscW(Strings.Mid(SMSMessageText, CharPosition, 1)) > 255) { IsItNonEnglish = true; break; } }	C# code to convert Arabic to Unicode public static string Getunicode(string Word) { char[] chararray = Word.ToCharArray(); byte[] unicodes = Encoding.Unicode.GetBytes(chararray); string unicodestring = ""; char[] tempChr = new char[1]; foreach (char chr in chararray) { tempChr[0] = chr; unicodestring += string.Format(@"{0}", string.Join("", Encoding.Unicode.GetBytes(tempChr).Select(x => x.ToString("x2")).Reverse())); } return unicodestring; }
PHP Script
PHP Code to convert submitted string/Arabic to Unicode. <?php require_once("smsutf8.inc"); /* create a unicode string / $s =" a b c ب"; / pass your message in above variable s */ $out = utf8ToUnicode($s); $outp = ""; for ($i=1;$i < strlen($s);$i++) { if (isset($out[$i-1])) { $outp = $outp . str_pad(dechex($out[$i-1]), 4, "0", STR_PAD_LEFT); } } echo $outp; ?>	PHP Include file, add following code in file smsutf8.inc and save it <?php function utf8ToUnicode(&$str) { $mState = 0; // cached expected number of octets after the current octet // until the beginning of the next UTF8 character sequence $mUcs4 = 0; // cached Unicode character $mBytes = 1; // cached expected number of octets in the current sequence $out = array(); $len = strlen($str); for($i = 0; $i < $len; $i++) { $in = ord($str{$i}); if (0 == $mState) { // When mState is zero we expect either a US-ASCII character or a // multi-octet sequence. if (0 == (0x80 & ($in))) { // US-ASCII, pass straight through. $out[] = $in; $mBytes = 1; } else if (0xC0 == (0xE0 & ($in))) { // First octet of 2 octet sequence $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x1F) << 6; $mState = 1; $mBytes = 2; } else if (0xE0 == (0xF0 & ($in))) { // First octet of 3 octet sequence $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x0F) << 12; $mState = 2; $mBytes = 3; } else if (0xF0 == (0xF8 & ($in))) { // First octet of 4 octet sequence $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x07) << 18; $mState = 3; $mBytes = 4; } else if (0xF8 == (0xFC & ($in))) { /* First octet of 5 octet sequence. * * This is illegal because the encoded codepoint must be either * (a) not the shortest form or * (b) outside the Unicode range of 0-0x10FFFF. * Rather than trying to resynchronize, we will carry on until the end * of the sequence and let the later error handling code catch it. / $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x03) << 24; $mState = 4; $mBytes = 5; } else if (0xFC == (0xFE & ($in))) { // First octet of 6 octet sequence, see comments for 5 octet sequence. $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 1) << 30; $mState = 5; $mBytes = 6; } else { / Current octet is neither in the US-ASCII range nor a legal first * octet of a multi-octet sequence. / return false; } } else { // When mState is non-zero, we expect a continuation of the multi-octet // sequence if (0x80 == (0xC0 & ($in))) { // Legal continuation. $shift = ($mState - 1) 6; $tmp = $in; $tmp = ($tmp & 0x0000003F) << $shift; $mUcs4 \|= $tmp; if (0 == --$mState) { /* End of the multi-octet sequence. mUcs4 now contains the final * Unicode codepoint to be output * * Check for illegal sequences and codepoints. / // From Unicode 3.1, non-shortest form is illegal if (((2 == $mBytes) && ($mUcs4 < 0x0080)) \|\| ((3 == $mBytes) && ($mUcs4 < 0x0800)) \|\| ((4 == $mBytes) && ($mUcs4 < 0x10000)) \|\| (4 < $mBytes) \|\| // From Unicode 3.2, surrogate characters are illegal (($mUcs4 & 0xFFFFF800) == 0xD800) \|\| // Codepoints outside the Unicode range are illegal ($mUcs4 > 0x10FFFF)) { return false; } if (0xFEFF != $mUcs4) { // BOM is legal but we don't want to output it $out[] = $mUcs4; } //initialize UTF8 cache $mState = 0; $mUcs4 = 0; $mBytes = 1; } } else { / ((0xC0 & (in) != 0x80) && (mState != 0)) * Incomplete multi-octet sequence. / return false; } } } return $out; } /* * Takes an array of ints representing the Unicode characters and returns * a UTF-8 string. Astral planes are supported ie. the ints in the * input can be > 0xFFFF. Occurrances of the BOM are ignored. Surrogates * are not allowed. * * Returns false if the input array contains ints that represent * surrogates or are outside the Unicode range. */ function unicodeToUtf8(&$arr) { $dest = ''; foreach ($arr as $src) { if($src < 0) { return false; } else if ( $src <= 0x007f) { $dest .= chr($src); } else if ($src <= 0x07ff) { $dest .= chr(0xc0 \| ($src >> 6)); $dest .= chr(0x80 \| ($src & 0x003f)); } else if($src == 0xFEFF) { // nop -- zap the BOM } else if ($src >= 0xD800 && $src <= 0xDFFF) { // found a surrogate return false; } else if ($src <= 0xffff) { $dest .= chr(0xe0 \| ($src >> 12)); $dest .= chr(0x80 \| (($src >> 6) & 0x003f)); $dest .= chr(0x80 \| ($src & 0x003f)); } else if ($src <= 0x10ffff) { $dest .= chr(0xf0 \| ($src >> 18)); $dest .= chr(0x80 \| (($src >> 12) & 0x3f)); $dest .= chr(0x80 \| (($src >> 6) & 0x3f)); $dest .= chr(0x80 \| ($src & 0x3f)); } else { // out of range return false; } } return $dest; } ?>

API for Only English Message text

API For sending SMS to Signle or multiple recipients (1 to 10 numbers only in each request) :-

http://cloud.smshat.com/API_SendSMS.aspx?User=xxxxxx&passwd=xxxxxxxxx&mobilenumber=xxxxxxx,xxxxxxx,xxxxx.. &message=xxxxxxxxx&sid=xxxxxxxx&mtype=N&DR=N&key=GeneratedAPIKeyHere
(Click here to test)

Or

http://cloud.smshat.com/API_SendSMS22.aspx?User=xxxxxx&passwd=xxxxxxxxx&mobilenumber=xxxxxxx,xxxxxxx,xxxxx.. &message=xxxxxxxxx&sid=xxxxxxxx&mtype=N&DR=N&key=GeneratedAPIKeyHere (API with mobile number validation)
(Click here to test)

API For sending thousands of SMS (For english message, 1 to 50,000 mobile numbers in each request):-

http://cloud.smshat.com/API_SendBulkSMS.aspx?User=demo&passwd=demo&mobilenumber=xxxxxxxxx,xxxxxxxxx,xxxxxxxxx&message=Test SMS%20msg%20please%20ignore&sid=Test&mtype=N&DR=Y&key=GeneratedAPIKeyHere

Select close

'                            VB.NET CODE

Imports System.Data
Imports System.IO
Imports System.Configuration
Imports System
Imports System.Net
Imports System.Text

Public Function SendSMS(ByVal User As String, ByVal password As String, ByVal Mobile_Number As String, ByVal Message As String, Optional ByVal MType As String = "N") As String
        Dim stringpost As String = "User=" & User & "&passwd=" & password & "&mobilenumber=" & Mobile_Number & "&message=" & Message & "&MTYPE=" & MType
        Dim functionReturnValue As String = Nothing
        functionReturnValue = ""

Dim objWebRequest As HttpWebRequest = Nothing
        Dim objWebResponse As HttpWebResponse = Nothing
        Dim objStreamWriter As StreamWriter = Nothing
        Dim objStreamReader As StreamReader = Nothing

Try
            Dim stringResult As String = Nothing

objWebRequest = DirectCast(WebRequest.Create("http://cloud.smshat.com/API_SendSMS.aspx"), HttpWebRequest)
            objWebRequest.Method = "POST"
            objWebRequest.ContentType = "application/x-www-form-urlencoded"
            objStreamWriter = New StreamWriter(objWebRequest.GetRequestStream())
            objStreamWriter.Write(stringpost)
            objStreamWriter.Flush()
            objStreamWriter.Close()

objWebResponse = DirectCast(objWebRequest.GetResponse(), HttpWebResponse)
            objWebResponse = DirectCast(objWebRequest.GetResponse(), HttpWebResponse)
            objStreamReader = New StreamReader(objWebResponse.GetResponseStream())
            stringResult = objStreamReader.ReadToEnd()
            objStreamReader.Close()
            Return (stringResult)
        Catch ex As Exception
            Return (ex.ToString)
        Finally

If (objStreamWriter IsNot Nothing) Then
                objStreamWriter.Close()
            End If
            If (objStreamReader IsNot Nothing) Then
                objStreamReader.Close()
            End If
            objWebRequest = Nothing
            objWebResponse = Nothing

End Try
    End Function

Protected Sub btnsubmit_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles btnsubmit.Click
        Dim str As String
        str = SendSMS(Trim(User1.Value), Passwd.Value, mobilenumber.Value, message.Value)
        Response.Write(str)
    End Sub

Select close

'######--------VB.NET-CODE---------#####

Imports System.Data
Imports System.IO
Imports System.Configuration
Imports System
Imports System.Net
Imports System.Text

Public Function SendSMS(ByVal User As String, ByVal password As String, ByVal Mobile_Number As String, ByVal Senderid As String, ByVal Message As String, Optional ByVal MType As String = "N") As String
        Dim stringpost As String = "User=" & User & "&passwd=" & password & "&mobilenumber=" & Mobile_Number & "&sid=" & Senderid & "&message=" & Message & "&MTYPE=" & MType
        Dim functionReturnValue As String = Nothing
        functionReturnValue = ""

Try
            Dim stringResult As String = Nothing

End Try
    End Function

Protected Sub btnsubmit_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles btnsubmit.Click
        Dim str As String
        str = SendSMS(Trim(User1.Value), Passwd.Value, mobilenumber.Value, senderid_title.Value, message.Value)
        Response.Write(str)
    End Sub

Select close

'####--- C# Sample CODE to send SMS ---####

using Microsoft.VisualBasic;
using System;
using System.Collections;
using System.Collections.Generic;
using System.Data;
using System.Diagnostics;
using System.IO;
using System.Configuration;
using System.Net;
using System.Text;
using System.Net;

public string SendSMS(string User, string password, string Mobile_Number, string Message, [System.Runtime.InteropServices.OptionalAttribute, System.Runtime.InteropServices.DefaultParameterValueAttribute("N")]  // ERROR: Optional parameters aren't supported in C#
string MType)
	    {
        string stringpost = "User=" + User + "&passwd=" + password + "&mobilenumber=" + Mobile_Number + "&message=" + Message + "&mtype=" + MType;
        //Response.Write(stringpost)
	        string functionReturnValue = null;
	        functionReturnValue = "";
	 
	        HttpWebRequest objWebRequest = null;
	        HttpWebResponse objWebResponse = null;
	        StreamWriter objStreamWriter = null;
	        StreamReader objStreamReader = null;
	 
	        try {
	            string stringResult = null;
	 
	         objWebRequest = (HttpWebRequest)WebRequest.Create("http://cloud.smshat.com/API_SendSMS.aspx");
                     
	            objWebRequest.Method = "POST";
	 
	            // Response.Write(objWebRequest)
	 
	 
	            
	            
	            // Please edit below lines if you are behind the proxy
	            //You can find both the parameters in Connection settings of your internet explorer.
	     
	            //System.Net.WebProxy myProxy = new System.Net.WebProxy(IPAddress, port);
	            //myProxy.BypassProxyOnLocal = true;
	            //objWebRequest.Proxy = myProxy;
	 
	            objWebRequest.ContentType = "application/x-www-form-urlencoded";
	 
	            objStreamWriter = new StreamWriter(objWebRequest.GetRequestStream());
	            objStreamWriter.Write(stringpost);
	            objStreamWriter.Flush();
	            objStreamWriter.Close();
	 
	            objWebResponse = (HttpWebResponse)objWebRequest.GetResponse();
	 
	 
	            objWebResponse = (HttpWebResponse)objWebRequest.GetResponse();
	 
	            objStreamReader = new StreamReader(objWebResponse.GetResponseStream());
	            stringResult = objStreamReader.ReadToEnd();
	            objStreamReader.Close();
	            return (stringResult);
	        } catch (Exception ex) {
	            return (ex.ToString());
	 
	        } finally {
	            if ((objStreamWriter != null)) {
	                objStreamWriter.Close();
	            }
	            if ((objStreamReader != null)) {
	                objStreamReader.Close();
	            }
	            objWebRequest = null;
	            objWebResponse = null;
	 
	        }
	    }
	 
	    protected void btnsubmit_Click(object sender, System.EventArgs e)
	    {
	        string str = null;
	        str = SendSMS(User.Value, Passwd.Value, mobilenumber.Value, message.Value,"N");
	        Response.Write(str);
	    }

Bulk SMS Gateway API: Integrate Text Messaging Into Your Applications!

Scroll Down To Check API Links!!!

The Benefits of SMSHat’s Bulk SMS Gateway API:

No Installations required

API Sample Interface

Ready-Made Scripts

XML API

SMSHat’s SMS API Formats:

API for Arabic + English (AnyLanguage/Unicode/Language/Non-English) Message text

API For sending SMS in Multi-Language text (English or Non-English or Arabic or Mix, 1 to 10 numbers only in each API request) :-

API For sending SMS in Multi-Language text in Unicode form (Non-English/Arabic/Unicode, 1 to 10 numbers only in each API request) :-

API For sending thousands of SMS (For Arabic/Unicode message, 1 to 50,000 mobile numbers in each request):-

Number of characters & SMS Credit & Billing

SMS API Parameter Details:

Unicode Converter : Convert any language to unicode value

Arabic To Unicode Conversion Scripts :

Javascript Code

VB Script

C# Script

PHP Script

API for Only English Message text

API For sending SMS to Signle or multiple recipients (1 to 10 numbers only in each request) :-

API For sending thousands of SMS (For english message, 1 to 50,000 mobile numbers in each request):-

Click here to download wordpress Form7 SMS integration, below are the steps to follow setup.