Introduction

The Nigeria SMS Depot HTTP API is a very popular bulksms API use by many organisations in Nigeria and other nations of the world.

The HTTP API is a simple and flexible method of integrating an our bulk sms gateway  easily with any website or application. It is very easy to use and also very flexible. Integrating it into any website or application to send and receive sms is just in a breeze.

The API code is made available online so that it becomes very easy for anyone to start using it effortlessly.

The only two requitrements to use it is to open an account with us, which of course is free to do, then buy sms credit quantity as per your need(s).

Features

The following are the features of Nigeria SMS Depot HTTP API:

• Send SMS to single mobile number
• Send SMS to multiple mobile number(s)
• Scheduling SMS
• Send Unicode SMS
• Send SMS to Group(s) on Nigeria SMS Depot

Parameters & Examples

#	Field Name	Field Value	Field Description
1	user	omomeji	The login name for your SMS account on Nigeria SMS Depot **Mandatory**
2	password	123456	The login password for your SMS account on Nigeria SMS Depot **Mandatory**
3	mobile	08012345678, 080xxxxxxxx	The target mobile number(s) separated with Comma **Mandatory**
4	senderid	King Adu	The sender name that will show as from address **Mandatory**
5	message	hi, happy birthday!	The text message to send to the target mobile number(s) **Mandatory**
6	schedule	2016:10:28:14:20:10	This is to schedule the SMS to deliver in future date. The format should be yyyy:mm:dd:hh:mm:ss
7	unicode	1 or 2	This is used for send Unicode sms via SMS HTTP API. Unicode=1 – You can directly send the  Unicode characters. Unicode = 2 – You can send Unicode converted as hex
8	group_id	group_id=1,2	Account holder Group(s) on Nigeria SMS Depot.

This is the API below:

http://www.smsdepot.com.ng/sendsms.php?user=&password=&mobile=&group_id=&senderid=&message=&unicode=&schedule=

Note: User, password, mobile, senderid and message are mandatory field that must have value for the API to work.

The sender id could be a number or letters or both but can not be more than 11 characters. 

Example 1

http://www.smsdepot.com.ng/sendsms.php?user=abc&password=xyz&mobile=0801XXXXXXX,0704XXXXXXX&group_id=1,2&senderid=SENDERID OR NAME&message=whatever it is but legal&unicode=1&schedule=yyyy:mm:dd:hh:mm:ss

Applying the field values from the table above as example you now have:

http://www.smsdepot.com.ng/sendsms.php?user=omomeji&password=123456&mobile=08012345678,080xxxxxxxx&group_id=1,2&senderid=King Adu&message=hi, happy birthday!&unicode=1&schedule=2016:10:28:14:20:10

If the field values above are to be valid ones ceteris paribus, the message, "hi, happy birthday!" will be delivered to the example mobile numbers and groups (08012345678,080xxxxxxxx&group_id=1,2) inputed above on 2016:10:28:14:20:10.

Example 2 (immediate delivery)

This: http://www.smsdepot.com.ng/sendsms.php?user=omomeji&password=123456&mobile=08012345678,080xxxxxxxx&group_id=1,2&senderid=King Adu&message=hi, happy birthday!&unicode=1&schedule=

will be delivered immidiately now!

API Response Codes

The following are the various response codes for success and failure:

1111:SUCCESS:SMS Submitted Successfully

1001:ERROR:Invalid URL

1005:ERROR:Invalid value in username or password field

1010:ERROR:Account expired

1015:ERROR:Insufficient SMS Credits

1020:ERROR:Invalid Sender

1025:ERROR:Invalid Schedule Time

1050:ERROR:Other error messages

1030:ERROR:Account doesn’t exist

1035:ERROR:Character count is greater than x

1040:ERROR:You are not allowed to Send Unicode Messages

1045:ERROR:Groups Not Found for Given Group Id(s)

 

If you would like a demo account for you to test the working of the API please sign up for free here.