API ENDPOINT
HTTP URL http://icesms.net/sms/smsAPI
HTTP Method POST or GET
Note: You'll need API Key and TOKEN. Please login to your account (or create one if you do not have already), then click on EXTRAS and then API


SENDING SMS
Sample Request
http://icesms.net/sms/smsAPI?sendsms&apikey=Your_API_KEY&apitoken=YOUR_API_TOKEN&type=sms&from=SENDERID&to=123456&text=My+first+text&scheduledate=2018-11-05 11:55:07&route=0
Parameters
apikey: You unique API Key (required)
apitoken: You unique API Token (required)
type: Message Type Eg. sms, voice, unicode, flash, mms, whatsapp (default is sms) (required)
from: Your Sender ID (required)
to: Destination Number (country code) (required)
text: Your message text (url encoded) (required for sms, unicode, flash)
file: Voice file URL (for voice message) or Multimedia file URL (for mms or whatsapp message) (optional)
language: Language of voice message (required for text-to-speach)
duration: Duration of your voice message in seconds (required for voice)
scheduledate: Date and Time to send message (YYYY-MM-DD HH:mm:ss) (optional)
route: ID of gateway/route to use for the message. Set to 0 to use system default routing rules (optional)
Sample Success Response (JSON) { "request": "sendsms", "status": "queued", "group_id": "1234", "date": "2018-11-05 11:55:07" }
Sample Error Response (JSON) { "request": "sendsms", "status": "error", "message": "Sender ID not allowed" }

CHECK SMS BALANCE
Sample Request
http://icesms.net/sms/smsAPI&groupstatus&apikey=Your_API_KEY&apitoken=YOUR_API_TOKEN&groupid=1234
Parameters
apikey: You unique API Key (required)
apitoken: You unique API Token (required)
groupid: The group_id returned by sendsms request (required)
Sample Success Response (JSON) { "request": "groupstatus", "status": "success", "group_id": "1234", "group_status": "sent", "recipients": [ { "id": "21", "to": "231235433", "status": "failed" }, { "id": "22", "to": "4471235433", "status": "sent" }, { "id": "25", "to": "1871235433", "status": "queued" } ], "date": "2018-11-05 11:55:07" }
Sample Error Response (JSON) { "request": "groupstatus", "status": "error", "message": "Error message", }

READ SMS INBOX
Sample Request
http://icesms.net/sms/smsAPI?getinbox&apikey=Your_API_KEY&apitoken=YOUR_API_TOKEN&list=unread
Parameters
apikey: You unique API Key (required)
apitoken: You unique API Token (required)
list: "all" will return all messages while "unread" will return only unread messages (default is unread) (optional)
Sample Success Response (JSON) { "request": "getinbox", "status": "success", "inbox": [ { "id": "12", "from": "123456789", "to": "2347015272", "message": "Hi. This is message 1", "date": "2018-11-05 11:55:07" }, { "id": "26", "from": "447882892", "to": "2347015272", "message": "Hi again. This is message 2", "date": "2018-11-05 11:55:07" } ] }
Sample Error Response (JSON) { "request": "getinbox", "status": "error", "message": "Error", }
CREDIT BALANCE
Sample Request
http://icesms.net/sms/smsAPI?balance&apikey=Your_API_KEY&apitoken=YOUR_API_TOKEN Parameters apikey: You unique API Key (required) apitoken: You unique API Token (required) Sample Success Response (JSON) { "balance": "12345" } Sample Error Response (JSON) { "request": "balance", "status": "error", "message": "Invalid user", }