Skip to content
View EasySendSMS's full-sized avatar

Block or report EasySendSMS

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
EasySendSMS/README.md

EasySendSMS — Bulk SMS API & Global SMS Gateway

Send SMS Worldwide | HTTP & REST API | SMPP Gateway | HLR Lookup | Number Validation | 2-Way SMS

Sign Up Free API Docs Coverage


EasySendSMS is a global bulk SMS platform and SMS API gateway built for developers, businesses, and enterprises. Send OTP codes, transactional alerts, marketing campaigns, and two-way messages to over 200 countries and 1,100+ mobile networks — starting from just $0.003 per SMS.

Whether you need a simple HTTP API call to send a single message or an SMPP connection for high-throughput enterprise messaging, EasySendSMS provides the infrastructure, documentation, and support to get you live in minutes.


API Endpoints

All API requests are made over HTTPS to api.easysendsms.app. The following endpoints are available:

Endpoint Base URL Description
Send SMS https://api.easysendsms.app/bulksms Send single or bulk SMS (up to 30 numbers per request)
Check Balance https://api.easysendsms.app/balance Query your current account credit balance
HLR Lookup https://api.easysendsms.app/hlr Check live subscriber status, roaming, ported network
Number Validation https://api.easysendsms.app/nv Validate number format, country, operator, and type

All endpoints support GET and POST methods. HTTPS is enforced for secure communication via SSL encryption.

For full parameter references, response formats, error codes, and code examples, visit the HTTP API Documentation or the REST API (v1) Documentation.


Quick Start — Send Your First SMS

Send an SMS in seconds using the HTTP API. Replace your_username and your_password with your EasySendSMS account credentials.

cURL

curl -X POST https://api.easysendsms.app/bulksms \
  -d "username=your_username" \
  -d "password=your_password" \
  -d "to=12345678900" \
  -d "from=MyBrand" \
  -d "text=Hello%20from%20EasySendSMS" \
  -d "type=0"

Python

import http.client
import urllib.parse

params = urllib.parse.urlencode({
    'username': 'your_username',
    'password': 'your_password',
    'to': '12345678900',
    'from': 'MyBrand',
    'text': 'Hello from EasySendSMS',
    'type': '0'
})

headers = {'Content-Type': 'application/x-www-form-urlencoded'}

conn = http.client.HTTPSConnection("api.easysendsms.app")
conn.request("POST", "/bulksms", params, headers)
res = conn.getresponse()
print(res.read().decode("utf-8"))

PHP

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://api.easysendsms.app/bulksms',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => 'username=your_username&password=your_password&to=12345678900&from=MyBrand&text=Hello%20from%20EasySendSMS&type=0',
    CURLOPT_HTTPHEADER => array('Content-Type: application/x-www-form-urlencoded'),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;

Successful Response:

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

More code examples in C#, Java, Node.js, and other languages are available in the Developer Hub.


Integration Methods

EasySendSMS supports multiple integration protocols to fit any architecture:

Method Best For Documentation
HTTP(S) API Simple integrations, web apps, scripts HTTP API Docs
REST API (v1) Modern applications, token-based auth REST API Docs
SMPP v3.4 High-throughput enterprise, aggregators SMPP Docs
Webhook (DLR) Real-time delivery receipt callbacks Webhook Docs
WordPress Plugin WordPress-based websites and stores WordPress Integration

Platform Features

Bulk SMS Gateway

Send hundreds to millions of SMS messages globally with a single request. Our intelligent routing engine delivers messages with high speed and high deliverability across 200+ countries and 1,100+ mobile networks. Set custom sender names, schedule messages, and track delivery in real time.

OTP & Transactional SMS

Priority routing ensures time-sensitive messages like one-time passwords (OTP), two-factor authentication (2FA) codes, order confirmations, and system alerts are delivered instantly. Our infrastructure is optimized for low-latency, high-reliability delivery.

HLR Lookup

Verify the live status of any mobile number before sending. Our HLR Lookup API returns subscriber status, roaming information, ported network data, MCC/MNC codes, and more. Clean your contact lists, reduce failed deliveries, and save on messaging costs.

Number Validation

Our Number Validation service checks whether a phone number is correctly formatted, identifies the country and original network, and determines if it is a mobile or landline number. Validate up to 30 numbers per request.

Virtual Numbers & 2-Way SMS

Rent dedicated virtual numbers to send and receive SMS. Enable two-way conversations with your customers for support, feedback, interactive campaigns, and opt-out management.

Webhook Delivery Receipts (DLR)

Receive real-time delivery status callbacks pushed directly to your server. Track message states (Delivered, Expired, Undelivered) and integrate delivery data into your CRM, analytics, or billing systems.


Developer Resources

Resource Link
Developer Hub easysendsms.com/developers
HTTP API Reference easysendsms.com/http-api
GitHub SDKs & Examples GitHub Repository
RapidAPI Integration EasySendSMS on RapidAPI
SMS Character Counter Character Counter Tool
Help Center KnowledgeBase & Guides

SMS API Error Codes

The following error codes apply to the Send SMS HTTP API (/bulksms):

Code Description
1001 Invalid URL. One of the parameters was not provided or left blank.
1002 Invalid username or password parameter.
1003 Invalid type parameter.
1004 Invalid message.
1005 Invalid mobile number.
1006 Invalid sender name.
1007 Insufficient credit.
1008 Internal error (do NOT re-submit the same message).
1009 Service not available (do NOT re-submit the same message).

Getting Started

  1. Create a free account at my.easysendsms.app/register — you get 15 free SMS credits instantly.
  2. Get your API credentials from the account dashboard.
  3. Choose your integration method — HTTP API, REST API, or SMPP.
  4. Send your first message using the code examples above or in the Developer Hub.

Support

Our support team is available 24/7 via multiple channels:

Channel Contact
Email support@easysendsms.com
WhatsApp +1 (213) 221-0324
Live Chat Available on easysendsms.com
Support Ticket Contact Us

Website · Developers · Countries Coverage · Contact Us

EasySendSMS Sdn. Bhd. — Empowering global connectivity since 2017.

Pinned Loading

  1. REST-API-v1 REST-API-v1 Public

    The EasySendSMS REST API offers a comprehensive set of tools designed to handle a wide range of communication tasks. Beyond sending and receiving SMS messages, our API supports HLR lookup for real-…

    1

  2. EasySendSMS-SMS-HTTPs-API EasySendSMS-SMS-HTTPs-API Public

    The HTTP-API allows you to integrate your system (client) to Easy Send SMS using the HTTP protocol to send SMS. HTTPS is also supported for secure transactions using SSL encryption.

    2

  3. EasySendSMS-HLR-HTTPs-API EasySendSMS-HLR-HTTPs-API Public

    With an HLR Lookup you can clean your data lists, or check the status of a phone before sending an SMS.

    3

  4. EasySendSMS-NV-HTTPs-API EasySendSMS-NV-HTTPs-API Public

    Number Validation (NV) HTTP(s) API (Get, Post Method), This service validates if the phone number is in the correct format, verifies the correct country code, and identifies the original network wh…

    1

  5. EasySendSMS-SMPP EasySendSMS-SMPP Public

    For our customers that require low level control of SMS messaging and lowest possible latency we offer our Enhanced SMPP service

    2

  6. EasySendSMS EasySendSMS Public

    Easy Send SMS provides you with everything from a high-quality bulk SMS messaging service

    2