शुरू करें

Bulk SMS API रेफरेंस

BulkSMSAPI डेवलपर्स के लिए एक बल्क SMS API है: REST के माध्यम से 227 देशों में एक रिक्वेस्ट पर एक टेक्स्ट या 10,000 नंबर तक का बैच भेजें, हर मैसेज को साइन्ड वेबहुक के साथ ट्रैक करें, और प्रीपेड बैलेंस से प्रति मैसेज भुगतान करें। यह रेफरेंस API के हर एंडपॉइंट, फील्ड, इवेंट और एरर को कवर करता है। हर पेज मार्कडाउन में भी उपलब्ध है: इसके एड्रेस में .md जोड़ें।

बेस URL और फॉर्मेट

सभी रिक्वेस्ट HTTPS पर https://bulksmsapi.cc/v1 पर जाती हैं। बॉडी JSON (Content-Type: application/json, UTF-8) है, और हर जवाब JSON में है, एरर भी। समय UTC में ISO 8601 फॉर्मेट में है। पैसा US डॉलर में पांच दशमलव स्थानों के साथ एक स्ट्रिंग है ("0.00507"), ताकि एक सेंट से कम की कीमतें सटीक हों।

एंडपॉइंट

मेथड और पाथयह क्या करता हैKey
POST /v1/messagesएक नंबर पर एक टेक्स्ट भेजेंYes
POST /v1/batches10,000 नंबर तक भेजें, एक टेक्स्ट या प्रति नंबर एकYes
GET /v1/messages/{id}एक मैसेज उसकी स्टेटस और कीमत के साथYes
GET /v1/messagesसंदेश, नवीनतम पहले, बैच या स्थिति के अनुसार फ़िल्टर करेंYes
GET /v1/batches/{id}एक बैच जिसमें प्रत्येक स्थिति की गणना होYes
GET /v1/batchesबैच, नवीनतम पहलेYes
POST /v1/batches/{id}/cancelएक निर्धारित बैच रद्द करें, पूर्ण धनवापसीYes
POST /v1/estimatesभेजे बिना एक अनुरोध की कीमत निर्धारित करेंYes
GET /v1/balanceUSD में बैलेंसYes
GET /v1/pricingप्रत्येक देश के लिए प्रति सेगमेंट कीमतNo
GET /v1/pricing/{country}एक देश के लिए कीमत (ISO कोड)No

पहला रिक्वेस्ट

कंसोल में एक API कुंजी बनाएं, उसे निर्यात करें, और एक संदेश भेजें। उत्तर 202 होगा जिसमें संदेश ऑब्जेक्ट होगा: लागत बैलेंस से ली जाएगी और संदेश कतारबद्ध हो जाएगा।

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155550123",
    "text": "Your Northwind code is 482913. It expires in 10 minutes.",
    "reference": "login-7781"
  }'
202 AcceptedJSON
{
  "id": "msg_8F3K2Q9TZ1MX",
  "object": "message",
  "batch_id": "bat_4M7Q1X0PK2RS",
  "to": "+14155550123",
  "country": "US",
  "text": "Your Northwind code is 482913. It expires in 10 minutes.",
  "segments": 1,
  "price": "0.00507",
  "currency": "USD",
  "status": "queued",
  "error": null,
  "reference": "login-7781",
  "created_at": "2026-11-07T09:30:12.418Z",
  "sent_at": null,
  "done_at": null
}

मैसेज कैसे मूव करता है

स्वीकृत संदेश queued होते हैं (या scheduled जब अनुरोध में send_at होता है)। कतार उन्हें हर दो सेकंड में नेटवर्क को सौंपती है, प्रति खाता प्रति मिनट 1,200 तक, और वे sent हो जाते हैं। अंतिम स्थिति delivered या failed होती है; विफल संदेश का धन तुरंत बैलेंस में वापस कर दिया जाता है। प्रत्येक अंतिम स्थिति आपके वेबहुक को एक हस्ताक्षरित इवेंट के साथ कॉल करती है।

लिमिट्स का सारांश

सीमामूल्य
प्रति API अनुरोध प्राप्तकर्ता10,000
प्रति कंसोल अभियान प्राप्तकर्ता50,000
प्रति कुंजी प्रति मिनट अनुरोध600
प्रति खाता प्रति मिनट नेटवर्क को सौंपे गए संदेश1,200
सबसे लंबा पाठ10 सेगमेंट (1,530 GSM-7 या 670 UCS-2 वर्ण)
शेड्यूल विंडो2 मिनट से 45 दिन आगे
प्रति इवेंट वेबहुक प्रयास10
Idempotency-Key मेमोरी24 घंटे
प्रति खाता API कुंजियाँ10

मशीन-रीडेबल फाइल्स

  • OpenAPI 3.1 स्पेक कोड जनरेटर और API क्लाइंट के लिए।
  • llms-full.txt: यह संपूर्ण संदर्भ एक सादे पाठ फ़ाइल के रूप में।
  • प्रत्येक दस्तावेज़ पृष्ठ Markdown के रूप में, उदाहरण के लिए /en/docs/webhooks.md।
Bulk SMS API रेफरेंस | BulkSMSAPI दस्तावेज़