JSON · HTTPS · Bearer key

एक SMS API से OTP कोड प्राप्त करें और SMS भेजें

TODAY SMS API एक डेवलपर API है, जो वन-टाइम नंबर पर कोड प्राप्त करने वाले SMS वेरिफ़िकेशन API और 227 देशों में भेजने वाले SMS भेजने के API को एक API key और एक बैलेंस में जोड़ता है। हर रिक्वेस्ट और रिस्पॉन्स JSON में है, और कीमतें व रिफ़ंड नियम वेबसाइट जैसे ही हैं।

API डॉक्स देखें साइन अप करें और key पाएं

today-sms.com/api/v1

$ curl -X POST https://today-sms.com/api/v1/numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app":"telegram","country":"indonesia"}'
{
  "id": "N-7K2M-QX4P-9D3A",
  "phone": "+6281234567890",
  "price": "0.4515",
  "status": "waiting",
  "expires_at": "2026-10-18T09:20:00.000Z"
}

$ curl https://today-sms.com/api/v1/numbers/N-7K2M-QX4P-9D3A \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "id": "N-7K2M-QX4P-9D3A",
  "status": "received",
  "sms": [
    { "code": "482913", "text": "Your code is 482913", "at": "2026-10-18T09:02:11.000Z" }
  ]
}

$ curl -X POST https://today-sms.com/api/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":["+14155550100","+447700900123"],"text":"Your code is 482913"}'
{
  "id": "m_7Q2K9X",
  "status": "queued",
  "recipients": 2,
  "parts": 1,
  "encoding": "GSM-7",
  "cost": "0.0136"
}

$ curl https://today-sms.com/api/v1/messages/m_7Q2K9X \
  -H "Authorization: Bearer YOUR_API_KEY"

प्रति मिनट 300 रिक्वेस्ट
प्राप्त करने और भेजने के लिए एक key
फ़ेल या न मिले का रिफ़ंड बैलेंस में
12 क्रिप्टो विधियों से टॉप-अप करें

SMS API से आप क्या कर सकते हैं

SMS वेरिफ़िकेशन API

ऐप और देश चुनें, नंबर खरीदें और वेरिफ़िकेशन कोड पाने के लिए उसका स्टेटस बार-बार जांचें। SMS न आए तो समय पूरा होने पर पूरी रकम बैलेंस में वापस आ जाती है।

SMS भेजने का API

अपना मैसेज एक साथ 1,000 रिसीवर्स तक भेजें और हर रिसीवर की डिलीवरी रिपोर्ट पाएं। शेड्यूल्ड समय जोड़ें तो उसी समय भेजा जाएगा।

कीमत और स्टॉक API

हर ऐप के देश और कीमतें, नंबरों की संख्या और हर देश की प्रति SMS कीमत API से पाएं, और उन्हें अपनी सर्विस में वैसे ही दिखाएं।

एक बैलेंस

प्राप्त करना और भेजना एक ही बैलेंस इस्तेमाल करते हैं। USDT से टॉप-अप करें और API से कभी भी जांचें।

तरीके एक नज़र में

पूरे डॉक्स

तरीका	यह क्या करता है
GET/balance	बैलेंस पाएं
GET/apps	ऐप्स की सूची
GET/prices?app=telegram	किसी ऐप के देश और कीमतें
POST/numbers	नंबर खरीदें
GET/numbers/{id}	नंबर का स्टेटस और SMS
POST/numbers/{id}/cancel	नंबर कैंसल करें
POST/numbers/{id}/finish	नंबर पूरा करें
GET/messages/prices	देश के अनुसार SMS कीमतें
POST/messages	SMS भेजें
GET/messages/{id}	भेजने का स्टेटस और डिलीवरी रिपोर्ट
POST/messages/{id}/cancel	शेड्यूल्ड भेजना कैंसल करें

SMS API क्या है?

SMS API एक कनेक्शन है, जिससे आपका सॉफ़्टवेयर HTTP रिक्वेस्ट से SMS प्राप्त या भेज सकता है। कोई व्यक्ति वेब स्क्रीन पर जो क्लिक करता, वह कोड करता है, इसलिए ऑटोमेटेड साइन अप टेस्ट, OTP कोड भेजना और ऑर्डर अलर्ट जैसे बार-बार होने वाले काम बिना किसी के हाथ लगाए चलते हैं।

TODAY SMS API दो चीज़ें साथ देता है। एक, वन-टाइम नंबर पर ऐप के वेरिफ़िकेशन कोड पाने के लिए SMS वेरिफ़िकेशन API (SMS एक्टिवेशन API), और दूसरा, दुनिया भर के मोबाइल फ़ोन पर SMS भेजने के लिए SMS भेजने का API। दोनों एक ही URL, एक ही API key और एक ही बैलेंस इस्तेमाल करते हैं, इसलिए न अलग साइन अप, न अलग टॉप-अप।

SMS वेरिफ़िकेशन API कैसे इस्तेमाल करें?

इसमें चार स्टेप हैं। GET /apps से ऐप कोड चुनें और GET /prices?app=CODE से देश और कीमतें देखें। POST /numbers से नंबर खरीदकर नंबर और उसकी id पाएं, फिर कोड आया या नहीं यह जानने के लिए हर कुछ सेकंड में GET /numbers/{id} कॉल करें। कोड मिलने के बाद POST /numbers/{id}/finish से नंबर बंद करें।

हर नंबर 20 मिनट तक SMS का इंतज़ार करता है, और उस समय में उसी नंबर पर आने वाले SMS का कोई अतिरिक्त खर्च नहीं। SMS न आए तो समय पूरा होने पर पूरी रकम बैलेंस में वापस आती है, और कुछ न आया हो तो खरीदने के 120 सेकंड बाद से आप POST /numbers/{id}/cancel से खुद कैंसल कर सकते हैं। ऐप वेरिफ़िकेशन ऑटोमेशन या बल्क वर्चुअल नंबर API की ज़रूरत हो, तो बस यही फ़्लो दोहराएं।

SMS भेजने का API कैसे इस्तेमाल करें?

POST /messages पर रिसीवर सूची (to) और मैसेज टेक्स्ट (text) भेजें, और आपको मैसेज id, रिसीवर्स की संख्या, भागों की संख्या और कुल खर्च वापस मिलता है। रिसीवर्स को + और कंट्री कोड के साथ अंतरराष्ट्रीय फ़ॉर्मेट में डालें, प्रति रिक्वेस्ट 1,000 तक। शेड्यूल करने के लिए at में UTC समय डालें।

भेजने के बाद GET /messages/{id} से हर रिसीवर की डिलीवरी रिपोर्ट देखें। चार स्टेटस हैं: pending, sent, delivered और failed, और failed पर खत्म होने वाले भागों की रकम refunded में जुड़कर बैलेंस में लौटती है। जो शेड्यूल्ड भेजना अभी नहीं गया है, उसे POST /messages/{id}/cancel से कैंसल करें।

OTP कोड भेजने के लिए भी यही तरीका इस्तेमाल करें। हर कोड एक SMS गिना जाता है और कोई अलग वेरिफ़िकेशन फ़ीस नहीं, और अपना खर्च निकालने के लिए GET /messages/prices से हर देश की प्रति SMS कीमत पा सकते हैं।

किफ़ायती SMS API में क्या देखें?

सिर्फ़ कीमत सूची की प्रति SMS कीमत नहीं, बल्कि असल में चुकाई जाने वाली कुल रकम देखें। TODAY SMS में कोई मासिक फ़ीस नहीं और सिर्फ़ भेजे गए भागों का चार्ज लगता है, और फ़ेल हुए भागों व कभी न आए वेरिफ़िकेशन कोड का रिफ़ंड बैलेंस में होता है।

अगला, कुंजी प्रबंधन और सीमाओं को देखें। आपको प्रति खाता एक API कुंजी मिलती है और किसी भी समय एक नई कुंजी बना सकते हैं, जो पुरानी कुंजी को तुरंत ब्लॉक कर देती है। अनुरोधों की अनुमति प्रति मिनट 300 तक है, जो अधिकांश स्वचालन के लिए पर्याप्त है। अंत में, भुगतान को देखें। आप बिना कार्ड के USDT, USDC और BTC सहित 12 क्रिप्टो तरीकों से टॉप अप कर सकते हैं, ताकि आप किसी भी देश से तुरंत शुरू कर सकें।

API key कैसे पाएं?

अकाउंट बनाएं, और पहला टॉप-अप जुड़ते ही API key पेज पर key बना सकते हैं। key सिर्फ़ बनाते समय एक बार दिखाई जाती है, इसलिए उसे सुरक्षित जगह रखें। हर रिक्वेस्ट के साथ उसे Authorization: Bearer हेडर में भेजें।

अगर आपको लगे कि आपकी key लीक हो गई है, तो API key पेज पर नई key बनाएं। पुरानी key तुरंत काम करना बंद कर देती है। आपकी key वाला कोई भी व्यक्ति आपके बैलेंस से नंबर खरीद सकता है या SMS भेज सकता है, इसलिए इसे कभी ब्राउज़र कोड या पब्लिक रिपॉज़िटरी में न डालें।

आज ही SMS API जोड़ें

साइन अप के लिए बस एक टोकन चाहिए। पहला टॉप-अप जुड़ते ही API key बनाएं, डॉक्स से सैंपल पेस्ट करें और अपनी पहली रिक्वेस्ट भेजें।