Do you need a reliable SMS Gateway API in Nigeria? Are you a developer or bulk SMS reseller? You can interface your application, website, or system with our 247 reliable messaging gateway by using our very flexible HTTP connection. Nigeria Bulk SMS is a reliable world-class system for A2P messaging with high delivery and throughput rate. You can connect with us for one-time password (OTP), transactional messages, promotional messages, international delivery, do not disturb (DND) delivery, bank, and corporate message delivery.

If you need an API connection that gives you peace of mind and a good return on investment, here you are.

Below is a detail of our HTTP API.

Text Message

https://portal.nigeriabulksms.com/api/?username=user&password=pass&message=test&sender=welcome&mobiles=2348030000000,2348020000000

Example Responses:

Success Response: {“status”:”OK”,”count”:1,”price”:8}

Failed Response: {“error”:”Login denied.”,”errno”:”103″}

Call Message

https://portal.nigeriabulksms.com/api/?username=user&password=pass&message=391000&sender=2348030000000&mobiles=2348020000000&type=call

Upload Audio

portal.nigeriabulksms.com/api/?username=623512d06c&password=f4e50093a6&action=upload&url=portal.nigeriabulksms.com/demo/sample.mp3

{“status”:”success”,”error”:””,”errno”:””,”data”:{“reference”:”ac798a79-f9e9-4662-c85b-f53ae1e62691″,”seconds”:22,”size”:”339.78KB”}}

Send TTS

https://portal.nigeriabulksms.com/api/?username=623512d06c&password=f4e50093a6&message=welcome+to+trillion.&type=tts&sender=2348040000000&mobiles=2348030000000

{“status”:”success”,”error”:””,”errno”:””,”data”:{“f75cfaec-5565-2044-449a-71f474f9f7d7″:”2348030000000”}}

Send Audio

https://portal.nigeriabulksms.com/api/?username=623512d06c&password=f4e50093a6&message=ac798a79-f9e9-4662-c85b-f53ae1e62691&type=call&sender=441120000000&mobiles=441130000000

{“status”:”success”,”error”:””,”errno”:””,”data”:{“b5703ef4-9730-c56e-d884-a314fe974cd6”:441130000000}}

Fetching Data

https://portal.nigeriabulksms.com/api/?username=user&password=pass&action=balance

Parameters for SMS Gateway API in Nigeria

1. login = Perform account login to validate a user
2. profile = The customer profile of the account
3. balance = The current balance on the account
4. contacts = The type (text, call, tts ) of the message
5. numbers = The saved numbers on the account
6. groups = The groups on the account
7. audios = The saved audios on the account
8. history = The message history on the account
9. scheduled = The scheduled messages on the account
10. reports = The delivery reports on the account
11. payments = The payment history on the account

Other Optional Parameters for Bulk SMS Gateway API

1. contacts = The list of contact ids to send the message
2. groups = The list of group ids to send the message
3. numbers = The list of number ids to send the message
4. type = The type (text, call, tts ) of the message
5. message = message text or audio reference number

Error Codes:

000 = Request successful 100 = Incomplete request parameters 101 = Request denied

110 = Login status failed 111 = Login status denied

120 = Message limit reached 121 = Mobile limit reached 122 = Sender limit reached

130 = Sender prohibited 131 = Message prohibited

140 = Invalid price setup 141 = Invalid route setup 142 = Invalid schedule date

150 = Insufficient funds 151 = Gateway denied access 152 = Service denied access

160 = File upload error 161 = File upload limit 162 = File restricted

190 = Maintenance in progress 191 = Internal error

 

PHP Sample Codes

https://portal.nigeriabulksms.com/api/examples/sendsms.txt

https://portal.nigeriabulksms.com/api/examples/sendsms-curl.txt

PHP Package

https://github.com/ossycodes/nigeriabulksms-php

Laravel Package

Get Laravel 5 and above Package for Nigeria Bulk SMS

JavaScript Package

Get JavaScript (JS) Package for Nigeria Bulk SMS

If you are having difficulty using our API Gateway, quickly contact us and we shall be more than happy to help.