API

API Documentation

Sending bulk SMS from your application, website or system has never been easier in Nigeria. Now with our robust, flexible and reliable SMS Application Programmable Interface (API) connection, you can send bulk SMS from your applications, websites or systems easily and fast. Our HTTP API allows integration to any front-end or legacy system with a direct connection into our premium gateways.

Note
: You must have an account with us to use our API. Register Now and start enjoying this unique feature.

Sending bulk SMS with HTTP API

End Point URL:

https://sms.com.ng/sendsms.php

API Parameters

Field Name Example Value Description
user * FrankUmeadi The login username for your SMS.com.ng account
password * 123456 The login password for your SMS.com.ng account
mobile * 08157165603,08066017971 The target mobile numbers separated by Comma
senderid * SMS.com.ng The sender name that will show as from address
message * Hello World! The actual text message to send to the target mobile numbers
schedule 2019:07:30:14:20:10 This is to schedule the SMS in future date. The format should be yyyy:mm:dd:hh:mm:ss (without white spaces)
group_id 1,2,3 Account holder Group id in SMS.com.ng.
dnd 0 or 1 This is used for sending SMS via DND gateway for DND enabled numbers 
DND = 0 (Do not send via DND gateway for DND enabled mobile numbers and automatically refund units for DND numbers) 
DND = 1 (Send via DND gateway for DND enabled mobile numbers)
unicode 1 or 2 This is used for sending Unicode SMS via SMS.com.ng HTTP API. 
Unicode = 1 (You can directly send the Unicode characters). 
Unicode = 2 (You can send Unicode converted as hex)
*are mandatory


Example [Sending to Mobile(s)]

https://sms.com.ng/sendsms.php?user=FrankUmeadi&password=123456&mobile=08157165603,08066017971&senderid=SMS.com.ng&message=HelloWorld&dnd=1

Example [Sending to Group(s)]

https://sms.com.ng/sendsms.php?user=FrankUmeadi&password=123456&group_id=1,2&senderid=SMS.com.ng&message=HelloWorld&dnd=1

Response Codes

1111:SUCCESS:SMS Submitted Successfully. (mobilecount=x, creditsused=y)

When all the mobile numbers are accepted for delivery.
1112:SUCCESS:SMS Submitted Successfully. (mobilecount=x, creditsused=y, failedcount=z)

When there are few numbers which are not accepted for delivery
1113:SUCCESS:SMS Scheduled Successfully
1001:ERROR:Invalid URL. User cannot be empty
1001:ERROR:Invalid URL. Password cannot be empty
1001:ERROR:Invalid URL. Mobile or Group id cannot be empty
1001:ERROR:Invalid URL. Message cannot be empty
1005:ERROR:Invalid value in username or password field
1030:ERROR:Account doesn't exist
1010:ERROR:Account expired
1015:ERROR:Your credits are Low
1020:ERROR:Invalid Sender
1040:ERROR:You are not allowed to send Unicode Messages
1050:ERROR:Character count is greater than X
1060:ERROR:Invalid Group id Specified
1070:ERROR:Invalid schedule time
1080:ERROR:Unable to schedule message
1090:ERROR:Unable to send message
1100:ERROR:Message has been waitlisted (mobilecount=x)

Checking SMS Units Balance

End Point URL:

https://sms.com.ng/balance.php

Parameters

Field Name Example Value Description
user * FrankUmeadi The login username for your SMS.com.ng account
password * 123456 The login password for your SMS.com.ng account
action * send The action string. It can be 'send' or 'receive' or 'account' (Please, always use 'send' for now.)
* are mandatory

Example [Getting SMS Units Balance]

https://sms.com.ng/balance.php?user=FrankUmeadi&password=123456&action=send

Response Codes

1112:SUCCESS:Total Send Credits:1000000 Used Credits: 84 Remaining credits: 999916
1113:SUCCESS:Total Receive Credits:1000 Used Credits: 50 Remaining credits: 950
1114:SUCCESS:{"name":"FrankUmeadi", "Totalsendcredits":"1000000", "Usedsendcredits":"84", "Remainingsendcredits":"999916", "TotalRrecivecredits":"1000", "UsedRrecivecredits":"50", "Remainingrecivecredits":"950", "createdDate":"28 Jan,2016 03:14 PM", "expiryDate":"03 Feb,2017 09:15 PM"}
1001:ERROR:Invalid URL. User cannot be empty
1001:ERROR:Invalid URL. Password cannot be empty
1055:ERROR:Please enter the valid action

Subscribe to Newsletter

Shhh… Don’t make a noise! Quietly subscribe to our newsletter today to get all the latest news about our free SMS units and other offers.

Contact Information

Office Address: 50 Cajaah Road, Orozo, Abuja, Nigeria

Phone & WhatsApp:+2348157165603

Email: hello@sms.com.ng

FOLLOW US

Copyright © 2019 SMS.com.ng. All rights reserved. Terms & Conditions | Privacy
SMS.com.ng Bank Details
SMS.com.ng Payment Methods