Bulk SMS API for Developers
Send promotional, transactional and OTP SMS from your website, app, CRM or ERP with one HTTPS GET request. No SDK to install. Check delivery for every number and your account balance through the same API.
Send Your First SMS
curl "https://sms.metareach.in/vb/apikey.php?apikey=YOUR_API_KEY&senderid=YOURID&number=91XXXXXXXXXX&message=Hello%20there"
Replace YOUR_API_KEY and YOURID (your DLT-approved sender ID) with your own details from the dashboard. The message must match one of your DLT-approved templates.
Endpoints
| Purpose | Endpoint (GET) | Key parameters |
|---|---|---|
| Send SMS | https://sms.metareach.in/vb/apikey.php | apikey, senderid, number, message |
| Personalised SMS | https://sms.metareach.in/vb/http-customize.php | Same as send; messages separated by ^, matched in order to the numbers |
| Delivery report | https://sms.metareach.in/vb/http-dlr.php | apikey, msgid |
| Balance | https://sms.metareach.in/vb/http-credit.php | apikey, route_id |
Send SMS parameters
| Parameter | Required | Description |
|---|---|---|
apikey | Yes | Your API key |
senderid | Yes | Your DLT-approved sender ID |
number | Yes | Mobile number(s), with or without 91; comma-separate for many |
message | Yes | URL-encoded text; up to 1,000 characters (500 for Unicode) |
route | No | Route type; defaults to transactional (1) |
unicode | No | 2 for regional-language text |
time | No | Schedule for later, e.g. 2026-12-20 04:00pm |
templateid | No | Your DLT template ID; if omitted, the message is matched to your registered templates |
short_url | No | Wrap a link in a trackable short URL |
format | No | json (default) or php |
Code Samples
PHP
<?php
$params = http_build_query([
'apikey' => getenv('MR_SMS_API_KEY'), // keep the key on your server
'senderid' => 'YOURID',
'number' => '91XXXXXXXXXX',
'message' => 'Your order 1234 has been shipped - BRANDNAME',
]);
$response = json_decode(file_get_contents('https://sms.metareach.in/vb/apikey.php?' . $params), true);
if (($response['code'] ?? '') === '011') {
$messageId = $response['data']['messageid']; // save it to check delivery later
}
Python
import os, requests
r = requests.get("https://sms.metareach.in/vb/apikey.php", params={
"apikey": os.environ["MR_SMS_API_KEY"],
"senderid": "YOURID",
"number": "91XXXXXXXXXX",
"message": "Your order 1234 has been shipped - BRANDNAME",
}, timeout=10)
data = r.json()
if data.get("code") == "011":
message_id = data["data"]["messageid"]
Node.js
const params = new URLSearchParams({
apikey: process.env.MR_SMS_API_KEY,
senderid: 'YOURID',
number: '91XXXXXXXXXX',
message: 'Your order 1234 has been shipped - BRANDNAME',
});
const res = await fetch(`https://sms.metareach.in/vb/apikey.php?${params}`);
const data = await res.json();
if (data.code === '011') console.log('Message ID:', data.data.messageid);
Successful response
{
"status": "Success",
"code": "011",
"description": "Message submitted successfully",
"data": { "messageid": "MzQz", "totnumber": "3", "totalcredit": "3" }
}
Send SMS Error Codes
| Code | Meaning |
|---|---|
| 001 | API key missing |
| 002 | Invalid route ID |
| 004 | No message found |
| 005 | Schedule time is in the past |
| 006 | Invalid date/time format |
| 007 | No numbers found |
| 008 | Insufficient credit |
| 009 | Parent account has insufficient balance |
| 010 | Message campaign failed |
| 011 | Success: message submitted |
Integration checklist
- Register your PE ID, sender ID and templates on DLT first.
- Store the API key in an environment variable on your server.
- URL-encode the message text.
- Save the
messageidand check the delivery report. - For OTP, follow our OTP best practices.
Endpoints and codes on this page are from the full SMS API documentation; check it for the latest details.
API SMS Rates
API and panel use the same rates.
| Monthly volume | Rate / SMS | Example | Base amount | GST (18%) | Total | Buy |
|---|---|---|---|---|---|---|
| 5,000 – 9,999 | ₹0.40 | 5,000 SMS | ₹2,000 | ₹360 | ₹2,360 | Buy Now |
| 10,000 – 19,999 | ₹0.30 | 10,000 SMS | ₹3,000 | ₹540 | ₹3,540 | Buy Now |
| 20,000 – 49,999 | ₹0.20 | 25,000 SMS | ₹5,000 | ₹900 | ₹5,900 | Buy Now |
| 50,000 – 99,999 | ₹0.15 | 50,000 SMS | ₹7,500 | ₹1,350 | ₹8,850 | Buy Now |
| 1,00,000 – 5,00,000 | ₹0.12 | 1,00,000 SMS | ₹12,000 | ₹2,160 | ₹14,160 | Buy Now |
| Below 5,000 or above 5,00,000 | Custom quote based on your volume and use case | Get Quote | ||||
Rates updated 20 November 2026. Same slabs for promotional, transactional, service and OTP SMS. Prices exclude 18% GST; totals include it.
Bulk SMS API: FAQ
Is there an SDK for the bulk SMS API?
No SDK is needed. Every endpoint is a plain HTTPS GET request, so you can call it from any language, from Postman, or with cURL.
Where do I get my API key?
Your API key is issued from your account dashboard once your account is active. Keep it on your server and never put it in app or browser code.
Can I send to many numbers in one request?
Yes. Pass several numbers separated by commas in the number parameter. To send a different message to each number, use the personalised SMS endpoint.
Can I send SMS in Hindi or other Indian languages?
Yes. Add unicode=2 to send regional-language text. A Unicode message can be up to 500 characters (1,000 for plain English text).
How do I know if a message was delivered?
Call the delivery report (DLR) endpoint with the message ID returned by the send request. It returns the status of each number, such as delivered or submitted, with the delivery time.
Get your API key
Tell us your use case and volume; we set up your account, DLT mapping and API access.