How can developers get free SMS API testing credits in India?

Developers can register a free sandbox account on SMSINDIAHUB to receive 100 complimentary test SMS credits. You can immediately generate your REST API key, test transactional and OTP message delivery routes, and preview live DLT compliance formats.

Which programming languages are supported by the SMS API?

The SMSINDIAHUB Gateway provides native code libraries and REST endpoints compatible with PHP (cURL), Python, Node.js, Java, C# (.NET Core), Go, and cURL CLI over standard HTTPS.

Is DLT registration mandatory for testing the Free SMS API in India?

For live recipient delivery across Indian telecom operators (Jio, Airtel, Vi, BSNL), TRAI mandates DLT registration with approved Entity ID (PEID) and Sender ID (Header). However, for development sandbox testing, you can use our pre-approved sandbox headers and templates.

What is the average latency of the OTP SMS API?

SMSINDIAHUB routes OTP messages through dedicated, high-priority banking-grade telecom pipes delivering sub-5-second message delivery across all Indian mobile operators.

Does the API support bulk broadcasts and schedule queuing?

Yes. The API supports batch broadcasting (up to 100 comma-separated numbers per GET request, or unlimited via HTTP POST/JSON batch payloads) as well as scheduled delivery using the schedtime parameter.

HTTP / HTTPS / SMPP REST API GET & POST Supported Free Test Credits Included

Free SMS API India | Free SMS Gateway API

Integrate the leading free SMS gateway developer API of India by SMSINDIAHUB. Use our best-in-class RESTful API to connect your software, mobile application, eCommerce store, ERP, and IoT hardware with instant carrier routing.

Send unlimited SMS via HTTP, HTTPS, and SMPP APIs suitable for both low-throughput notifications and high-throughput enterprise pipelines.

Get Free API Key with Free Credits → Explore Endpoints & Code Samples ↓

REST API Specifications

SMS API Endpoints With Live Request Formats

Select an API method below to inspect endpoint URLs, required parameters, and sample JSON responses.

Endpoint 01

Single SMS API (Promotional & Transactional & API key)

Promotional SMS – Single Message GET URL:

https://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user=abc&password=xyz&msisdn=919898xxxxxx&sid=SenderId&msg=test%20message&fl=0

Transactional SMS – Single Message GET URL (with gwid=2):

https://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user=abc&password=xyz&msisdn=919898xxxxxx&sid=SenderId&msg=test%20message&fl=0&gwid=2

API –Instead of the username and password you can use the API key for authentication of account

https://cloud.smsindiahub.in/api/mt/SendSMS?APIKey=apikey&senderid=ABABAB&channel=Trans&DCS=0&flashsms=0&number=910xxxxxxx&text=IDSIHUB

Parameters Reference:

• user: Your SIH login username.

• password: Your SIH login password or API Key.

• msisdn: Destination mobile number (10 digits or with 91 prefix).

• sid: Approved 6-character alphabetic Sender ID.

• msg: Message content (URL encoded). Note: If using templates, fill approved dynamic fields.

• fl: 1 for Flash message, 0 for standard SMS.

• gwid: Set to 2 for Transactional / DND delivery route.

• API Key: you will find your API Key in your SMS account.

Expected JSON Response:

{"ErrorCode":"000","ErrorMessage":"Success","JobId":"381a8090-b230-42fa-ac04-157cc2142bfa","MessageData":[{"MobileNumber":"919898xxxxxx","MessageParts":[{"MessageId":"919898xxxxxx-67e3765cdf034f438a432eacb88d0c14","MessagePartId":1,"MessageText":"test message"}]}]}

Endpoint 02

Multiple SMS API (Comma Separated Numbers)

Multiple SMS via Username & Password:

https://cloud.smsindiahub.in/api/mt/SendSMS?user=demo&password=demo123&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx,91999xxxxxxx&text=test message&DLTTemplateId=##&route=##&PEId=##

Multiple SMS via API Key:

https://cloud.smsindiahub.in/api/mt/SendSMS?APIKey=123456789&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx,91999xxxxxxx&text=test message&route=##&PEId=##

Note: Only 100 mobile numbers are allowed. (pass with comma separated).

Batch JSON Response:

{"ErrorCode":"000","ErrorMessage":"Done","JobId":"20047","MessageData":[{"Number":"91989xxxxxxx","MessageId":"mvHdpSyS7UOs9hjxixQLvw"},{"Number":"91999xxxxxxx","MessageId":"PfivClgH20iG6G5R3usHwA"}]}

Endpoint 03

Send SMS Tiny (Link Shortener & Click Tracking)

Request URL:

https://cloud.smsindiahub.in/api/mt/SendSmsTiny?user=demo&password=demo123&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx&text=test message&route=##&PEId=##&&IsConvertLinkToTiny=""

Response JSON:

{"ErrorCode":"000","ErrorMessage":"Done","JobId":"20047","MessageData":[{"Number":"91989xxxxxxx","MessageId":"mvHdpSyS7UOs9hjxixQLvw"},{"Number":"917405080952","MessageId":"PfivClgH20iG6G5R3usHwA","IsConvertLinkToTiny":""}]}

Endpoint 04

Schedule SMS API

Schedule SMS via Username & Password:

https://cloud.smsindiahub.in/api/mt/SendSMS?user=demo&password=demo123&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx&text=test message&schedtime=2015/12/31 22:35:00 PM&route=##

Schedule SMS via API Key:

https://cloud.smsindiahub.in/api/mt/SendSMS?APIKey=123456789&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx&text=test message&schedtime=2015/12/31 22:35:00 PM&route=##

* Note: The schedtime format is yyyy/mm/dd hh:mm:ss PM (e.g. 2015/12/31 22:35:00 PM).

Response JSON:

{"ErrorCode":"000","ErrorMessage":"Done","JobId":"20047","MessageData":[{"Number":"91989xxxxxxx","MessageId":"BqTiw66A2UGLFV3DnwHFLQ"}]}

Endpoint 05

Group SMS API

Group SMS via Username & Password:

https://cloud.smsindiahub.in/api/mt/SendSMS?user=demo&password=demo123&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx&text=test message&groupid=###&route=##

Group SMS via API Key:

https://cloud.smsindiahub.in/api/mt/SendSMS?APIKey=123456789&senderid=WEBSMS&channel=Promo&DCS=0&flashsms=0&number=91989xxxxxxx&text=test message&groupid=###&route=##

Response JSON:

{"ErrorCode":"000","ErrorMessage":"Done","JobId":"20047","MessageData":[{"Number":"91989xxxxxxx","MessageId":"mvHdpSyS7UOs9hjxixQLvw"},{"Number":"91999xxxxxxx","MessageId":"PfivClgH20iG6G5R3usHwA"}]}

Endpoint 06

Sign Up API

https://cloud.smsindiahub.in/api/auth/signup?username=demo&password=demo123&mobile=911441231231&emailid=demo@gmail.com

Response:

Success#user created successfully.

Endpoint 07

Check Balance API

Check Balance GET URL:

https://cloud.smsindiahub.in/api/mt/GetBalance?User=demo&Password=demo123

Response JSON:

{"ErrorCode":"0","ErrorMessage":"Done","Balance":"Promo:9988|Trans:0"}

Endpoint 08

Check Delivery API

Check Delivery GET URL:

https://cloud.smsindiahub.in/api/mt/GetDelivery?user=demo&password=demo123&jobid=#######

Response JSON:

{"ErrorCode":"0","ErrorMessage":"Done","MessageId":null,"DeliveryReports":[{"MessageId":"mvHdpSyS7UOs9hjxixQLvw","DeliveryStatus":"Delivered","DeliveryDate":"2015-09-28T06:17:00"},{"MessageId":"PfivClgH20iG6G5R3usHwA","DeliveryStatus":"Delivered","DeliveryDate":"2015-09-28T06:17:00"}]}

Endpoint 09

Check Sent Report API

Sent Report GET URL (Date Range):

https://cloud.smsindiahub.in/api/mt/GetSentReport?user=demo&password=demo&fromdate=2017-12-04&todate=2017-12-05

* Note: Parameters fromdate and todate accept yyyy-mm-dd or yyyy/mm/dd formats.

Endpoint 10

2Factor Authentication API Specification (v1.0)

The 2 Factor Authentication API is a RESTful API for adding strong two-factor authentication to your website or application.

First Step:

1. Signup for a 2FA Account.

2. Login to Admin Panel and Click on API Key to get your Key.

1. Send Auto Generated SMS OTP:

https://2factorauthentication.in/auth/api/send_otp/api_key/{API_KEY}/mobile/{MOBILE}/mail/{EMAIL}

Example:

https://2factorauthentication.in/auth/api/send_otp/api_key/abcdefgh123456789/mobile/1234567890/mail/test@gmail.com

Success Response:

{"code":"E801", " message ":"OTP Sent Successfully","status ":"success", "otp_id":"123456"}

Failed Response:

{"code":"E803", " message ":" API Key didn't receive in request headers","status ":"failed"}

2. Verify SMS OTP Input:

https://2factorauthentication.in/auth/api/verify_otp/api_key/{API_KEY}/otp_id/{OTP_ID}/otp/{OTP}

Example:

https://2factorauthentication.in/auth/api/verify_otp/api_key/abcdefgh123456789/otp_id/789012/otp/123456

Success Response:

{"code":"E901", " message ":"OTP Verified Successfully","status ":"success"}

Failed Response:

{"code":"E803", " message ":" API Key didn't receive in request headers","status ":"failed"}

Status & Error Codes Reference:

Send OTP Codes:

'E801': OTP Sent Successfully

'E803': API Key didn't receive in request headers

'E804': Invalid API Key

'E805': Customer has been deactivated

'E806': SMS service is not active

'E807': cURL Error

'E808': Insufficient SMS Balance

'E809': Something Went Wrong.

'E810': SMS API’s User ID is required

'E811': SMS API’s key is required

'E812': SMS API's Password is required

'E813': SMS SID is required

'E814': Recipient is required

'E815': Invalid Customer ID

Verify OTP Codes:

'E901': OTP Verified Successfully

'E902': Invalid API Key or OTP ID

'E903': API Key didn't receive in request headers

'E904': OTP ID is required

'E905': OTP is required

'E906': OTP is expired

'E907': Something Went Wrong. Internal Error

'E908': OTP Verification Failed

'E909': Something Went Wrong. Internal Error

'E910': OTP Already Expired

Endpoint 11

XML API POST Specification

Post Data to:

https://cloud.smsindiahub.in/api/mt/SendSMS?

Single & Multiple SMS XML Payload Structure:

<?xml version="1.0" encoding="utf-8" ?>
<SMS>
  <Account>
    <User>demo</User>
    <Password>demo123</Password>
    <!-- Or <APIKey>123456789</APIKey> -->
    <SenderId>WEBSMS</SenderId>
    <Channel>Promo</Channel>
    <DCS>0</DCS>
    <FlashSMS>0</FlashSMS>
    <Route>##</Route>
    <PEId>##</PEId>
  </Account>
  <Messages>
    <Message>
      <Number>91989xxxxxxx</Number>
      <Text>test message</Text>
      <DLTTemplateId>##</DLTTemplateId>
    </Message>
    <Message>
      <Number>91999xxxxxxx</Number>
      <Text>test message 2</Text>
      <DLTTemplateId>##</DLTTemplateId>
    </Message>
  </Messages>
</SMS>

Reference Guide

Parameter Information

Parameter Name	Group	Description
user	Account	Your login username
password	Account	Your login password
APIKey	Account	Instead of the username and password you can use the api key for authentication of account
senderid	Message	Approved sender id (6 characters string only).
channel	Message	Message channel promotional or transactional
route	Message	Pass the route id in this parameter to route the message. Click Here for more information regarding your routeid.
DCS	Message	Data coding value (Default is 0 for normal message, Set 8 for unicode sms)
flashsms	Message	Flash message immediate display (Default is 0 for normal sms, Set 1 for immediate display)
number	Message	Recipient mobile number (pass with comma seprated if need to send on more then one number)
text	Message	Your sms content
schedtime	Optional	Schedule date and time for scheduling message (DateTime formate will be 2014/10/06 20:30:00 PM yyyy/mm/dd hh:mm:ss PM)
groupid	Optional	group id for numbers. (Note: Only 100 mobile numbers are allowed).

System Error Codes

API Error Code Reference (000 - 036)

When making HTTP requests to SMSINDIAHUB endpoints, inspect the ErrorCode parameter in the JSON response against the standardized status codes below:

Error Code	Description / Status
000	Done
001	login details cannot be blank
003	sender cannot be blank
004	message text cannot be blank
005	message data cannot be blank
006	error: generic error description
007	username or password is invalid
008	account not active
009	account locked, contact your account manager
010	api restriction
011	ip address restriction
012	invalid length of message text
013	mobile numbers not valid
014	account locked due to spam message contact support
015	senderid not valid
017	groupid not valid
018	multi message to group is not supported
019	schedule date is not valid
020	message or mobile number cannot be blank
021	insufficient credits
022	invalid jobid
023	parameter missing
024	invalid template or template mismatch
025	{Field} can not be blank or empty
026	invalid date range
027	invalid optin user
028	Invalid Data
029	Email can not be blank
030	Password can not be blank
031	Username can not be blank
032	Mobile number can not be blank
033	UserName already exist
034	Mobile number already exist
035	EmailId already exist
036	EmailId can not be blank

Endpoint 15

Unicode Regional SMS API (DCS=8)

Hindi / Regional Languages GET URL:

https://cloud.smsindiahub.in/api/mt/SendSMS?APIKey=apikey&senderid=ABABAB&channel=Trans&DCS=8&flashsms=0&number=919898xxxxxx&text=%E0%A4%86%E0%A4%AA%E0%A4%95%E0%A4%BE%20OTP%205421%20%E0%A4%B9%E0%A5%88

* Note: Set DCS=8 for UTF-8 / Unicode characters. Each 70-character count constitutes 1 SMS credit for Unicode messages.

Endpoint 16

Automated Voice Call OTP API

Voice Broadcast GET Request:

https://cloud.smsindiahub.in/voice/api/send_otp.aspx?user=abc&password=xyz&number=919898xxxxxx&otp=4592&lang=en

Endpoint 17

2-Way Virtual Mobile Long Code API

Inbound Webhook Forwarding URL:

https://yourdomain.com/sms-receiver.php?sender=919898xxxxxx&keyword=TRACK&message=TRACK%2012345&timestamp=1700000000

Endpoint 18

5-Digit Dedicated Short Code Webhook

Short Code Dispatch Callback:

https://yourdomain.com/shortcode-listener.php?shortcode=56767&sender=919898xxxxxx&keyword=SIH&text=SIH%20DEMO

Endpoint 19

Global International SMS Gateway API

International HTTP Endpoint:

https://cloud.smsindiahub.in/api/mt/SendSMS?APIKey=apikey&senderid=GLOBAL&channel=Trans&DCS=0&flashsms=0&number=14155552671&text=Welcome%20to%20Global%20Portal

Integration SDKs & Scripts

SMS API With Ready-To-Use Sample Code

Copy and paste verified code snippets into your application in PHP, ASP, C#, VB.NET, or Java.

PHP 7.4+ / PHP 8+ cURL Implementation

<?php
// SMSINDIAHUB Free SMS Gateway API Integration (PHP cURL)
$user     = "your_username";
$password = "your_password_or_apikey";
$msisdn   = "9198XXXXXXXX";       // Destination Mobile Number
$sid      = "SMSHUB";             // 6-Character Approved Sender ID
$msg      = urlencode("Dear User, your verification code is 6547. Valid for 10 mins.");
$fl       = "0";                  // 0 = Normal SMS, 1 = Flash SMS
$gwid     = "2";                  // 2 = Transactional / DND Route

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "http://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user={$user}&password={$password}&msisdn={$msisdn}&sid={$sid}&msg={$msg}&fl={$fl}&gwid={$gwid}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

C# (.NET Core / ASP.NET)

using System;
using System.IO;
using System.Net;
using System.Text;

class SMSIndiaHubSender
{
    static void Main()
    {
        string user = "YOUR_USERNAME";
        string password = "YOUR_PASSWORD";
        string mobile = "9198XXXXXXXX";
        string senderId = "WEBSMS";
        string message = Uri.EscapeDataString("Hi, Thanks for signing up with SMSINDIAHUB.");
        
        string url = $"http://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user={user}&password={password}&msisdn={mobile}&sid={senderId}&msg={message}&fl=0&gwid=2";
        
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
        request.Method = "GET";
        
        using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
        using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
        {
            string result = reader.ReadToEnd();
            Console.WriteLine(result);
        }
    }
}

VB.NET Implementation

Imports System.IO
Imports System.Net

Public Class SMSBroadcast
    Public Sub SendSMS()
        Dim sURL As String = "http://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user=YourUser&password=YourPass&msisdn=9198XXXXXXXX&sid=WEBSMS&msg=Test%20SMS&fl=0&gwid=2"
        Dim request As WebRequest = WebRequest.Create(sURL)
        Using response As WebResponse = request.GetResponse()
            Using stream As Stream = response.GetResponseStream()
                Using reader As New StreamReader(stream)
                    Dim result As String = reader.ReadToEnd()
                    Console.WriteLine(result)
                End Using
            End Using
        End Using
    End Sub
End Class

Java Standard HTTP Connection

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;

public class SMSIndiaHubClient {
    public static void main(String[] args) {
        try {
            String user = "username";
            String password = "password";
            String msisdn = "9198XXXXXXXX";
            String sid = "WEBSMS";
            String msg = URLEncoder.encode("Your verification OTP is: 123456", "UTF-8");

            String endpoint = "http://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user=" + user 
                + "&password=" + password + "&msisdn=" + msisdn + "&sid=" + sid + "&msg=" + msg + "&fl=0&gwid=2";

            URL url = new URL(endpoint);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("GET");

            BufferedReader rd = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            StringBuilder response = new StringBuilder();
            String line;
            while ((line = rd.readLine()) != null) {
                response.append(line);
            }
            rd.close();
            System.out.println("Response: " + response.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Classic ASP (VBScript Msxml2.ServerXMLHTTP)

<%
Dim sUser, sPassword, sNumber, sMessage, sSenderID, sURL, objXmlHttpMain
sUser = "username"
sPassword = "password"
sNumber = "9198XXXXXXXX"
sMessage = "Test SMS from SMS INDIA HUB"
sSenderID = "WEBSMS"

sURL = "http://cloud.smsindiahub.in/vendorsms/pushsms.aspx?user=" & sUser & "&password=" & sPassword & "&msisdn=" & sNumber & "&sid=" & sSenderID & "&msg=" & Server.URLEncode(sMessage) & "&fl=0&gwid=2"

Set objXmlHttpMain = Server.CreateObject("Msxml2.ServerXMLHTTP")
objXmlHttpMain.open "GET", sURL, False
objXmlHttpMain.send
Response.Write(objXmlHttpMain.responseText)
Set objXmlHttpMain = Nothing
%>

Integration Tutorial

How to integrate bulk SMS API in PHP?

To integrate Bulk SMS in PHP, first create an account with SMSINDIAHUB to generate your API Key and sender ID. Next, initialize a PHP cURL session or file_get_contents query, pass the target mobile number and approved DLT template content in URL-encoded format, and execute the request.

Explore Developer API Playground →

Business Advantages

Why SMS API integration?

SMS API integration is the process required to integrate SMS services with websites, software, mobile applications, and billing portals. It provides the fastest, most reliable method to send automated transactional notifications, 2FA security tokens, payment confirmations, and customer alerts directly from your core platform.

Get Free Test Account →

Full CPaaS Stack

Supported SMS Gateway Developer APIs

✔ Send SMS API

✔ Balance Check API

✔ Unicode SMS API

✔ Single SMS API

✔ Multiple SMS API

✔ Delivery Check API

✔ 2FA Auth API

✔ Long Code API

✔ Short Code API

✔ Voice Call OTP API

✔ XML API

✔ International SMS API

Frequently Asked Questions

Developer SMS API Questions & Answers

Everything you need to know about free developer sandbox credits, API protocols, DLT compliance, and latency benchmarks.

READY TO CONNECT YOUR APP?

Start Building with Free SMS API Today

Claim your 100 free developer sandbox testing credits, generate your REST API key, and send your first test SMS in under 5 minutes with full DLT support.

Instant API & DLT Activation

99.95% Guaranteed SLA

Free Demo

24/7 Dedicated Support

Get Free API Key Start Free Sandbox +91 8305781001

Get in Touch With Us

Quick setup • Free trial credits • Dedicated manager