HTTP(s) SMS API

HTTP Response

The HTTP response from our system contains the following:

OK: Message ID (Internal use only), sent successfully.

Error message (if present), message not sent successfully.

Status Codes

If the message has been sent successfully the status code will return as below:

Example:

OK: 760d54eb-3a82-405c-a7a7-0a0096833615

If the message was unable to be delivered it will return {Error code}

Example:

1001

Example:

Below are example for (Get Method) request when using the HTTP interface.

Example Send Single SMS (English)

https://api.easysendsms.app/bulksms?username=testuser&password=secret&from=Test&to=12345678910&text=Hello%20world&type=0

The message has to be URL encoded and the type parameter has to be set to (type=0).

Output:

OK: 760d54eb-3a82-405c-a7a7-0a0096833615

Example Send To Multi Numbers (Bulk SMS)

https://api.easysendsms.app/bulksms?username=testuser&password=secret&from=Test&to=12345678910,12345678910,12345678910,12345678910,12345678910&text=Hello%20world&type=0

A request containing multiple destinations numbers will be aborted immediately if any error other than “Invalid Destination” is found. In case an invalid destination is found we just skip that destination number and proceed to the next destination number, maximum you can send 30 numbers per submission.

Note: Duplicate numbers will be ignored.

Output:

OK: 760d54eb-3a82-405c-a7a7-0a0096833615, OK: 34763d84-683e-4b53-bd9f-fc9eb8c532b7

Example Send Single SMS (Unicode)

https://api.easysendsms.app/bulksms?username=testuser&password=secret&from=Test&to=12345678910&text=006500610073007900730065006E00640073006D0073002E0063006F006D&type=1

The message has to be encoded on the UTF-16BE format and the type parameter has to be set to (type=1).

Output:

OK: 34763d84-683e-4b53-bd9f-fc9eb8c532b7

API rate limit:

To maintain a high quality of service to all customers, EasySendSMS API applies rate limits for its SMS API.
The default request rate limit is 30 request per second per account and can reach up to 150 requests per second per IP address,
( Contact our support if you wish to have that ).

The API will reject all requests exceeding this rate limit with 429 Too Many Requests HTTP Status.

The SMPP connection rate limit can reach up to 300 to 500 SMS per sec and can be adjusted upon request,
( Contact our support if you wish to have that ).
You can retry the request after 1 second.

• .NET
• PHP
• Java
• Paython

var options = new RestClientOptions("")
{
MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("https://api.easysendsms.app/bulksms", Method.Post);
request.AddHeader("Content-Type", "application/x-www-form-urlencoded");
request.AddHeader("Cookie", "ASPSESSIONIDASCQBARR=NKOHDCHDOFEOOALJIGDGGPAM");
request.AddParameter("username", "username");
request.AddParameter("password", "password");
request.AddParameter("to", "12345678900");
request.AddParameter("from", "test");
request.AddParameter("text", "Hello world");
request.AddParameter("type", "0");
RestResponse response = await client.ExecuteAsync(request);
Console.WriteLine(response.Content);
                                            

$curl = curl_init();
                                                                                
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api.easysendsms.app/bulksms',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => 'username=username&password=password&to=12345678900&from=test&text=Hello%20world&type=0',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/x-www-form-urlencoded',
'Cookie: ASPSESSIONIDASCQBARR=NKOHDCHDOFEOOALJIGDGGPAM'
),
));
                                                                            
$response = curl_exec($curl);
                                                                            
curl_close($curl);
echo $response;
                                            

Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("https://api.easysendsms.app/bulksms")
.header("Content-Type", "application/x-www-form-urlencoded")
.header("Cookie", "ASPSESSIONIDASCQBARR=NKOHDCHDOFEOOALJIGDGGPAM")
.field("username", "username")
.field("password", "password")
.field("to", "12345678900")
.field("from", "test")
.field("text", "Hello world")
.field("type", "0")
.asString();
                                            

import http.client

conn = http.client.HTTPSConnection("api.easysendsms.app")
payload = 'username=username&password=password&to=12345678900&from=test&text=Hello%20world&type=0'
headers = {
'Content-Type': 'application/x-www-form-urlencoded',
'Cookie': 'ASPSESSIONIDASCQBARR=NKOHDCHDOFEOOALJIGDGGPAM'
}
conn.request("POST", "/bulksms", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))