send sms worldwide from 2 naira only

PluralSMS API

If you need to send SMS from your application or you are building a site for your own bulk sms business, PluralSMS provides a very simple API that will allow you to quickly connect from your application.

First, sign up on pluralsms and buy SMS units that will be enough for your test, then request api access by mailing info@pluralsms.com

 

USING GET

Send Text

http://pluralsms.com/sms/sms_api/command/send?user={username}&pass={password}&msg={message}&num={number}&sender={sender}&isflash={0|1}

Required - user, pass, msg, num, sender

Optional - isflash

Note: Sender can be Alphanumeric or a registered number with PluralSMS on sign up

 

Check Balance

http://pluralsms.com/sms/sms_api/command/credits?user={username}&pass={password}

 

Check Delivery Report

http://pluralsms.com/sms/sms_api/command/delrpt?user={username}&pass={password}&msgids={messageids}

 

We advise that you use get only for testing as it's less secure. Use POST method below in production.

 

 

TO SEND TEXT

Use the following url to send text:

http://pluralsms.com/sms/sms_api/command/send

then the following parameters should be sent via POST method to the url. This can be done using a form element or CURL or AJAX using the POST method.

 

e.g. 

<form method="POST" action="http://pluralsms.com/sms/sms_api/command/send">

<input type="hidden" name="user" value="{username}">

<input type="hidden" name="pass" value="{password}">

<input type="hidden" name="msg" value="{message}">

<input type="hidden" name="num" value="{number}">

<input type="hidden" name="sender" value="{sender}">

<input type="hidden" name="isflash" value="{0|1}">

</form>

 

{number} is comma separated list of numbers. Please don't include curly braces in all cases.

 

TO CHECK CREDIT

Use http://pluralsms.com/sms/sms_api/command/credits to check credit.

 

The parameters to be sent (via POST) are:

       user={username}

       pass={password}

 

TO POLL DELIVERY REPORTS

Use the url http://pluralsms.com/sms/sms_api/command/delrpt to poll for delivery reports.

 

The parameters to be sent (also via POST) are:

      user={username}

      pass={password}

      msgids={messageids} (optional)

 

{messageids} is comma separated list of message ids previously captured from the send request in your database. If specified, the delivery reports of only those messages will be returned. If not specified, all delivery reports will be returned. Please don't include curly braces.

 

RESPONSE CODES

These are response codes for any of the actions above:

    '-1' => 'Authentication Error',

    '-2' => 'Access Denied',

    '-3' => 'Insufficient Credit',

    '-4' => 'Missing Message',

    '-5' => 'Missing Recipient',

    '-6' => 'Missing Sender',

    '-7' => 'Invalid Recipient',

    '-8' => 'Invalid Sender ID',

    '-9' => 'General Error',

 

If message is succesfully sent, then the following response will be received

 

<errorcode>|<number>|<message id>|<status>|<error msg>

 

Where <errorcode> is 0 if message is successful. A separate line will be sent for each successful message

E.g.

0|23480xxxxxxxx|1002928383737|1|

0|23480xxxxxxxx|1022928383737|0|

 

<status> is 1 for success and 0 for failure

 

For credit checks a positive number value (representing credits available) will be returned if successful

 

For delivery reports, the following response will be received for a successful request

 

<message id>|<number>|<status>|<sendtime>|<donetime>

 

Where status is either DELIVERED, NOT_DELIVERED, SENT, NOT_SENT, REJECTED, EXPIRED, UNKNOWN or UNDEFINED.

 

<sendtime> and <donetime>are Unix timestamps set in UTC timezone. Ensure you do the appropriate timezone conversion for display to your users.

 

E.g.

1002928383737|23480xxxxxxxx|DELIVERED|1234567890|1234576890

A GreenLand Technologies SMS Company