QUICK SMS

Please Confirm
QUICK SMS
SENT MESSAGES

API

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 send sms, check account balance, get deliver reports and sent messages or check your balance.

CONNECTION METHOD

GET METHOD

Connect to send single or multiple sms messages through the following api url: http://www.quicksms1.com/api/sendsms.php?username=user&password=1234 &sender=quicsms1&message=testing&recipient=2348030000000,23480xxxxxxxx&report=1&convert=1

POST METHOD

Use this method to send sms messages where the length of "GET METHOD" is a limitation,
url: http://www.quicksms1.com/api/sendsms.php
Data to post: username=user&password=1234&sender=quicsms1&message=testing &recipient=2348030000000,23480xxxxxxxx&report=1&convert=1


The parameters are:
1. recipient : The destination phone numbers. Separate multiple numbers with comma(,)
3. username: Your quicksms1 account username
4. password: Your quicksms1 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 "2010-10-01 12:30:00" i.e "YYYY-MM-DD HH:mm:ss"
7. convert: Specify and set this parameter to 1 only when you want to get the return code in string readable format instead of the raw numbers below;
8. report: Set this parameter to 1 to retrieve the message id which can later be used to retrieve the delivery report or else remove it or set it to 0

The return values are:
OK = Successful
1 = Invalid Recipient(s) Number
2 = Cant send Empty Message
3 = Invalid Sender ID
4 = Insufficient Balance
5 = Incorrect Username or Password Specified
6 = Incorrect schedule date format
7 = Error sending message (Gateway not available), Please try again later

Example:
On success, the following code will be returned
OK 21 = 4564

i.e 'OK' 'No of sms credits used' = 'Unique Message ID'
where OK = The message was sent successfully
21 = No of sms credits used
and 4564 = The unique message id of the sent message which can be used to retrieve the delivery status of the sent message.
Note: When using GET METHOD to send message, the values should be properly encoded before sending it to our server

CHECK ACCOUNT BALANCE

You can use GET or POST METHOD to query your quick sms account balance. http://www.quicksms1.com/api/sendsms.php?username=user&password=1234&balance=1

The parameters are:
1. username: Your quicksms1 account username
2. password: Your quicksms1 account password
3. balance: This most be included to inform our server that you want to only check your account balance

On successful, Your account balance would be returned e.g 5024


DELIVERY REPORT

Use Get Method to query the delivery report/status of the sent message using the message id. http://www.quicksms1.com/api/getdelivery.php?username=user&password=1234&msgid=4564

The parameters are:
1. username: Your quicksms1 account username
2. password: Your quicksms1 account password
3. msgid: The message id of the sent message you want to retrieve the delivery status
3. html: Only Set this parameter to 1, to return the report in colourful html table format. e.g html=1

On success, the following code will be returned.
2349038781252=DELIVERED=2015/10/25 23:11:34, 2349055552635=SENT=----/--/-- --:--:--
i.e 'Number' = 'Delivery Status' = 'Date and Time of delivery'
where 2349038781252 = Phone number
DELIVERED = The message had delivered
2015/10/25 23:11:34 = The date and time the message was delivered.