SMS API Integration in IndiaRESTful API. Authentication. Delivery-status reporting.
Review the bulk SMS API for your application in India. Send transactional, promotional and OTP messages with a documented REST workflow, authentication guidance and delivery-status endpoints.
Plan Your SMS API Integration
Follow the documented steps to prepare authentication, message templates and delivery-status handling.
Review Authentication
Confirm the account credentials and Authorization header format required by your integration.
Prepare Message Details
Confirm the sender, message category and template details that apply to your Indian SMS workflow.
Send and Monitor
Call the relevant endpoint, handle the response and use delivery-status reporting in your application.
Integration Examples
Copy-paste ready code in your preferred language. Send personalized SMS with variable substitution.
curl -X POST https://api.bharatbulksms.com/v2/sms/send \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": ["919876543210"],
"sender_id": "BHARAT",
"message": "Hello {{name}}, your OTP is {{otp}}. Valid for 5 minutes.",
"variables": {
"919876543210": { "name": "Rajesh", "otp": "482910" }
},
"route": "transactional",
"template_id": "1107161234567890123"
}'Success Response (200 OK)
{
"status": "success",
"message": "SMS queued successfully",
"data": {
"message_id": "msg_7f3a2b1c9d4e5f6a",
"credits_used": 2,
"recipients": 2,
"route": "transactional",
"scheduled": false
}
}API Reference
Complete list of available endpoints. Click to expand parameters and details.
API Authentication
Bearer Token Authentication
All API requests must include your API key in the Authorization header. Your API key carries full account privileges โ keep it secure and never expose it in client-side code.
Base URL
https://api.bharatbulksms.com/v2Content Type
application/jsonRate Limits & Quotas
Rate limits vary by plan. Contact us for custom enterprise limits.
| Plan | API Requests | Bulk Batch Size | Concurrent |
|---|---|---|---|
| Starter | 100 req/min | 10,000 SMS/batch | 5 connections |
| Business | 500 req/min | 50,000 SMS/batch | 20 connections |
| Enterprise | 2,000 req/min | 1,00,000 SMS/batch | 100 connections |
Rate limit headers are included in every response: X-RateLimit-Remaining, X-RateLimit-Reset. Implement exponential backoff when you receive a 429 response.
HTTP Status Codes
Standard HTTP status codes indicate success or failure of API requests.
Delivery Status Webhooks
Receive real-time delivery reports via HTTP POST to your callback URL.
Webhook Payload
When a message delivery status changes, we send a POST request to your registered callback URL with the following JSON payload. Respond with HTTP 200 to acknowledge receipt.
{
"event": "delivery_report",
"message_id": "msg_7f3a2b1c9d4e5f6a",
"to": "919876543210",
"status": "delivered",
"delivered_at": "2026-07-17T10:30:45+05:30",
"error_code": null,
"credits_refunded": 0
}deliveredMessage delivered to handset
failedDelivery failed (DND, invalid number)
pendingMessage in transit to operator
Official SDKs
Pre-built libraries for popular languages. Install and start sending in minutes.
Python
pip install bharatbulksmsNode.js
npm install bharatbulksmsPHP
composer require bharatbulksms/sdkJava
Maven: com.bharatbulksms:sdkRuby
gem install bharatbulksms.NET
dotnet add package BharatBulkSMSReady to Integrate?
Review the API reference and contact our team when you are ready to discuss an integration workflow.