• Customer Support

    (+234) 8022631770

Use Our API in Any of Your Website or Apps

You can interface an application, website or system with our messaging gateway by using our very flexible HTTP API connection. Once you're connected, you'll be able to deliver messages or check your balance.

 

The API Parameters and What They Stand For:

API NAME: Empire BulkSMS

1. recipient : The destination phone numbers. Separate multiple numbers with comma(,)
3. username: Your empiresms.com account username
4. password: Your empiresms.com account password
5. sender: The sender ID to show on the receiver's phone
6. message: The text message to be sent
7. balance: Set to true only when you want to check your credit balance
6. schedule: Specify this parameter only when you are scheduling an sms for later delivery. It should contain the date the message should be delivered. Supported format is "2009-10-01 12:30:00" i.e "YYYY-MM-DD HH:mm:ss"

HTTP API Configuration

HTTP API:
http://www.empiresms.com/index.php?option=com_spc&comm=spc_api&username=user&password=1234&sender=@@sender@@&recipient=@@recipient@@&message=@@message@@&

HTTP API(SPC3 Format):
http://www.empiresms.com/components/com_spc/smsapi.php?username=user&password=1234&sender=@@sender@@&recipient=@@recipient@@&message=@@message@@&

API to Check Your Bulk SMS Balance:
http://www.empiresms.com/index.php?option=com_spc&comm=spc_api&username=user&password=1234&balance=true

API to Check Your Bulk SMS Balance(SPC3 Format):
http://www.empiresms.com/components/com_spc/smsapi.php?username=user&password=1234balance=true

 
API response on Success: OK
API Response confirmation: Contains
API Protocol: HTTP GET
Push to API as: Bulk
 

The return values are

OK=Successful
-2904=SMS Sending Failed
-2905=Invalid username/password combination
-2906=Credit exhausted
-2907=Gateway unavailable
-2908=Invalid schedule date format
-2909=Unable to schedule
-2910=Username is empty
-2911=Password is empty
-2912=Recipient is empty
-2913=Message is empty
-2914=Sender is empty
-2915=One or more required fields are empty

Example:
On success, the following code will be returned
OK 21 08033333333,08022222222,08055555555

i.e OK no of sms credits used gsm numbers that failed
where 21=no of sms credits used and 08033333333,08022222222,08055555555 are the 3 numbers that failed

Get the latest updates on our BBM Channel. Join us on EmpireSMS BBM Channel.. (Pin: C00264CD5)

Site Users

Today22
Yesterday41
This week86
This month585
Total15737

Wednesday, 20 September 2017 21:08