HTTP

We provide Simple & easy way to integrate with websites & Application by using our HTTP API , its easy & quick way to Start Sending & receiving messages. Support both HTTP and HTTPS protocols. It can use GET or POST both methods.

We provide HTTP API for one2one for customized message & one2many for sending common message in a group of numbers at once.

HTTP GET/POST to Send SMS

Make an HTTP GET / POST request to the send SMS list resource URL: http://api.smsccenter.com/pushsms.php

The variables to be used are as follows:

Parameter Description
User Your user name.
Password Your password.
Phone Number Mobile number of the recipient(s).
Text The text of the message.
Hint: Charged 1 unit for 160 characters per recipient.
Sender Alphanumeric/Number SenderID from your approved list of SenderID's  if you do not have privilege of dynamic sender ID(s) to be used for GSM / CDMA Recipients.

Optional Parameters

Parameter Description
Type This parameter has the specific message type like Unicode message/ flash message.
If you wish to  send the message which should flash directly on the screen of mobile then send type value as 1  e.g. type=1 or
If you wish to send sms which content Unicode character(s) then send type value as 2  e.g. type=2
Note: 70 Unicode characters makes 1 sms
Time This parameter has schedule time for post (later) auto delivery on future time.
e.g.  time=201212010930 ( Date: 2012 12 01  & Time: 09.30 AM )
Note: Time can be send in 24 hours format with correct Date of future, schedule cant be set more than 3 months from the date of request time while you send sms by API.
Track If you wish to Track the delivery status of the message then send value as 1  e.g. track=1
Binary If you wish to send binary sms then send value of binary as 1  e.g. binary=1
sr This parameter has the sequence number of any mobile number against each request id.  Numeric value for more than one number in any sequence against each request id.
e.g sr=1 or sr=1,2,3,12,14 ( if recipient is more than one )

Example:

Simple Text Messages to single recipient
http://api.smsccenter.com/pushsms.php?user=username&password=yourpassword&sender=YourSnederID&
text=This+is+a+sample+sms&PhoneNumber=91XXXXXXXXXX&track=1

OUTPUT

101 Message Sent. trackid: E1CD74F1-F279-F298-9517-05D1E11C6E66
Numbers Processed:1
Invalid Numbers:0
Duplicate Numbers:0
NDNC Numbers:0
Valid Numbers:1
Balance Credits:45

Simple Text Messages to multiple recipient
http://api.smsccenter.com/pushsms.php?user=username&password=yourpassword&sender=YourSnederID&
text=This+is+a+sample+sms&PhoneNumber=91XXXXXXXXXX,91XXXXXXXXXX&track=1

OUTPUT

101 Message Sent. trackid: J15D74F1-G279-F294-9517-05D1E11C6T61
Numbers Processed:2
Invalid Numbers:0
Duplicate Numbers:0
NDNC Numbers:0
Valid Numbers:2
Balance Credits:43

Some useful Tips / Information for sending sms by HTTP API
When a text message is being submitted via the "Text" parameter, then due to URL escaping restrictions, space characters should be replaced with "+" characters. There are also some certain special characters, such as "?", "&", ":" and “=” need to be replaced with an escape character while submitting to our API. The SMSC gateway expects characters to be encoded in UTF-8 (Unicode-based) format, therefore some characters, including the Euro (€) may require multiple escaped characters.

Note: This is only applicable in APIs not in our WEB SMS Interface, our interface automatically performs this escaping while sending message by using our WEB SMS Interface.

Following table below shows some common characters that must be escaped while sending sms using our API by GET/ POST method :

+ %2B
& %26
% %25
\ %5C
+ %2B
# %23
! %21
* %2A
= %3D
%27
, %2C
%22
< %3C
%E2%82%AC
Message text up to 160 characters in length can be sent in a single SMS message.

Response Code

Code Description
100 Your message has been submitted & queued for outbound SMSC.
101 Your message has been submitted with track id & queued for outbound SMSC.
102 Authentication failure.  e.g. INVALID User name / Password.
103 No enough Credits/Account  or Account Expired.
104 Invalid Sender ID.
105 No recipient mobile Number(s).
106 Blank Message, No content found to send sms.
107 Unicode Message but message type value is not set to 1 e.g. unicode=1
108 Access Denied. API ( HTTP / XML ) not enabled, Contact your provider.
109 Invalid Message Template. Please use Approved Message Template to Send Message.
For more details you can write us on: support@smsccenter.com