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

PurposeEndpoint (GET)Key parameters
Send SMShttps://sms.metareach.in/vb/apikey.phpapikey, senderid, number, message
Personalised SMShttps://sms.metareach.in/vb/http-customize.phpSame as send; messages separated by ^, matched in order to the numbers
Delivery reporthttps://sms.metareach.in/vb/http-dlr.phpapikey, msgid
Balancehttps://sms.metareach.in/vb/http-credit.phpapikey, route_id

Send SMS parameters

ParameterRequiredDescription
apikeyYesYour API key
senderidYesYour DLT-approved sender ID
numberYesMobile number(s), with or without 91; comma-separate for many
messageYesURL-encoded text; up to 1,000 characters (500 for Unicode)
routeNoRoute type; defaults to transactional (1)
unicodeNo2 for regional-language text
timeNoSchedule for later, e.g. 2026-12-20 04:00pm
templateidNoYour DLT template ID; if omitted, the message is matched to your registered templates
short_urlNoWrap a link in a trackable short URL
formatNojson (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

CodeMeaning
001API key missing
002Invalid route ID
004No message found
005Schedule time is in the past
006Invalid date/time format
007No numbers found
008Insufficient credit
009Parent account has insufficient balance
010Message campaign failed
011Success: 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 messageid and 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 volumeRate / SMSExampleBase amountGST (18%)TotalBuy
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.

WhatsApp