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.
Make an HTTP GET / POST request to the send SMS list resource URL: http://api.smsccenter.com/pushsms.php
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. |
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 ) |
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
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
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 |
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. |