डेवलपर प्लेटफ़ॉर्म

Temp Number API - फ़ोन नंबर, SMS और OTP

वर्चुअल फ़ोन नंबर प्राप्त करें, रीयल-टाइम में SMS पाएँ और OTP वेरिफ़िकेशन ऑटोमेट करें - एक साफ़ REST API से, या सीधे अपने AI असिस्टेंट से।

REST · JSON AI एजेंट के लिए MCP cURL · Node.js · Python · PHP
BASE URL https://api.temp-number.com/v1
API दस्तावेज़ v1 API कुंजी पाएँ

होम / डेवलपर्स

परिचय

Temp Number API अनुमानित संसाधनों के आधार पर व्यवस्थित है, मानक HTTP verbs इस्तेमाल करता है और हर जवाब JSON में लौटाता है। एक कुंजी केवल आपके अपने खाते को पढ़ने और लिखने की पहुँच देती है - किसी दूसरे खाते तक पहुँच नहीं है।

प्रोटोकॉलHTTPS · JSON
ऑथBearer कुंजी
वर्ज़नv1 (स्थिर)
एंडपॉइंट17 लाइव

क्विकस्टार्ट

शून्य से वेरिफ़िकेशन कोड तक। अपनी भाषा एक बार चुनें - पेज का हर उदाहरण उसी में दिखेगा।

  1. API कुंजी बनाएँ

    Dashboard → API Access में एक कुंजी बनाएँ। यह एक बार दिखाई जाती है: इसे एनवायरनमेंट वेरिएबल TEMP_NUMBER_API_KEY के रूप में सेव करें।

  2. अपना बैलेंस जाँचें

    हर कॉल में आपकी कुंजी Authorization हेडर में जाती है। किसी हानिरहित चीज़ से शुरुआत करें: आपका वॉलेट बैलेंस।

    curl --request GET "https://api.temp-number.com/v1/account" \
      --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
      --header "Accept: application/json"
  3. देश चुनें और स्टॉक जाँचें

    GET /pricing हर देश को हर अवधि की सटीक कीमत के साथ दिखाता है। फिर अपने चुने हुए देश का स्टॉक पक्का करें।

    curl --request GET "https://api.temp-number.com/v1/inventory?country_code=US&duration=oneMonth" \
      --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
      --header "Accept: application/json"
  4. नंबर खरीदें

    हर खरीदारी के साथ एक नई Idempotency-Key भेजें। अगर नेटवर्क टूट जाए, तो उसी कुंजी के साथ फिर से प्रयास करें: आपसे कभी दो बार शुल्क नहीं लिया जाता। जवाब से data.id सहेज लें।

    curl --request POST "https://api.temp-number.com/v1/numbers/buy" \
      --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
      --header "Accept: application/json" \
      --header "Content-Type: application/json" \
      --header "Idempotency-Key: $(uuidgen)" \
      --data '{"country_code":"US","duration":"oneMonth"}'
  5. SMS पढ़ें

    संदेश आने तक हर कुछ सेकंड में नंबर को पोल करें। आपको मूल टेक्स्ट मिलता है; कोड आप अपनी ओर से निकालें।

    curl --request GET "https://api.temp-number.com/v1/numbers/1482/sms" \
      --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
      --header "Accept: application/json"
  6. SMS नहीं आया? रिफ़ंड के लिए रद्द करें

    खरीद के 15 से 120 मिनट के बीच, जिस नंबर पर कोई SMS नहीं आया है उसे रद्द करके पूरी राशि वॉलेट में रिफ़ंड पाई जा सकती है।

    curl --request POST "https://api.temp-number.com/v1/numbers/1482/cancel" \
      --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
      --header "Accept: application/json" \
      --header "Idempotency-Key: $(uuidgen)"

प्रमाणीकरण

हर अनुरोध पर अपनी API कुंजी मानक Authorization हेडर में भेजें:

http
Authorization: Bearer YOUR_API_KEY
  • API Access में कुंजियाँ बनाएँ। बनाते समय कुंजी पूरी केवल एक बार दिखाई जाती है।
  • हर इंटीग्रेशन के लिए अलग key इस्तेमाल करें, ताकि एक को रद्द करने पर बाकी न टूटें। पासवर्ड बदलने पर सभी keys रद्द हो जाती हैं।
  • गायब, गलत फ़ॉर्मैट वाली या रद्द की गई कुंजी पर 401 मिलता है। जिस खाते ने अपना ईमेल सत्यापित नहीं किया है, या जो निलंबित है, उस पर 403 मिलता है, code email_unverified या account_suspended के साथ।
  • REST कुंजियाँ केवल /v1 पर काम करती हैं। MCP सर्वर अपना साइन-इन या MCP कुंजियाँ इस्तेमाल करता है - MCP सर्वर देखें।
अपनी कुंजी को पासवर्ड की तरह संभालें। इसे अपने सर्वर पर रखें, कभी किसी वेब पेज या मोबाइल ऐप में नहीं। अगर यह कभी लॉग, कमिट या साझा हुई हो, तो इसे तुरंत बदलें।

बेस URL और वर्ज़निंग

सभी एंडपॉइंट स्थायी /v1 प्रीफ़िक्स के तहत हैं:

base url
https://api.temp-number.com/v1

जोड़ने वाले बदलाव - नए फ़ील्ड, एंडपॉइंट या वैकल्पिक पैरामीटर - बिना वर्ज़न बदले जारी होते हैं, इसलिए जिन फ़ील्ड को आप नहीं जानते उन्हें अनदेखा करें। कोई ब्रेकिंग बदलाव /v2 के तहत जारी होगा; आपका इंटीग्रेशन कभी चुपचाप नहीं बदला जाता। मशीन-पठनीय अनुबंध OpenAPI spec है।

अनुरोध और जवाब

  • हर अनुरोध पर JSON बॉडी Content-Type: application/json के साथ भेजें, और Accept: application/json भी भेजें।
  • सफलता: { "success": true, "data": …, "meta": {…} }। meta में गिनती, पेजिनेशन और राशि का सारांश होता है।
  • त्रुटियाँ: { "success": false, "message": "…", "code": "…" }। code के आधार पर ब्रांच करें; संदेश लोगों के पढ़ने के लिए है। त्रुटियाँ देखें।
  • समय ISO 8601 में होते हैं। राशि दो दशमलव वाले USD में होती है - हमेशा वही कीमत जो आप चुकाते हैं।
  • कुछ ऑब्जेक्ट में मौजूदा इंटीग्रेशन के लिए अब भी पुराने फ़ील्ड नाम हैं (रेफ़रेंस में deprecated चिह्नित)। नए कोड को इन्हें अनदेखा करना चाहिए।
जवाबों में कभी किसी अपस्ट्रीम प्रदाता का नाम या थोक लागत नहीं दिखती। आपको सिर्फ़ वही कीमत दिखती है जो आपके वॉलेट से ली जाती है - इसे अपने उपयोगकर्ताओं को दिखाना सुरक्षित है।

त्रुटियाँ

त्रुटियाँ मानक HTTP स्टेटस कोड इस्तेमाल करती हैं। बिज़नेस त्रुटियों में एक स्थिर, मशीन-पठनीय code होता है; कुछ में अधिक संदर्भ के साथ details भी होता है।

422 · बिज़नेस त्रुटि
{
  "success": false,
  "message": "Insufficient wallet balance.",
  "code": "insufficient_funds"
}
422 · वैलिडेशन त्रुटि
{
  "message": "The country code field is required.",
  "errors": {
    "country_code": ["The country code field is required."]
  }
}
स्थितिcodeअर्थक्या करें
400 - buy, renew या cancel पर Idempotency-Key हेडर नहीं है या गलत फ़ॉर्मैट में है। Body: {"error": "Missing Idempotency-Key header."} Idempotency-Key में एक UUID भेजें।
401 - कोई bearer टोकन नहीं, गलत फ़ॉर्मैट वाला टोकन, या रद्द की गई कुंजी। Authorization हेडर जाँचें; अगर कुंजी रद्द की गई हो तो नई कुंजी बनाएँ।
403 email_unverified अकाउंट ने अभी तक अपना ईमेल पता सत्यापित नहीं किया है। वेबसाइट पर ईमेल सत्यापित करें, फिर दोबारा प्रयास करें।
403 account_suspended अकाउंट निलंबित है। सपोर्ट से संपर्क करें।
403 kyc_required नए नंबर खरीदने से पहले अकाउंट को अपनी पहचान सत्यापित करनी होगी। कोई शुल्क नहीं लिया गया; रिन्यूअल अब भी काम करते हैं। अकाउंट सेटिंग्स में पहचान सत्यापन पूरा करें, फिर दोबारा प्रयास करें।
403 - कुंजी के पास API एक्सेस नहीं है (उदाहरण के लिए MCP कुंजी), या GET /receive-sms से किसी दूसरे अकाउंट के नंबर के बारे में पूछा गया। REST API कुंजी का उपयोग करें; केवल अपने नंबरों के बारे में पूछें।
404 - नंबर, संदेश या देश आपके अकाउंट में नहीं है या अभी बिक्री पर नहीं है। दूसरे अकाउंट की id पर भी 404 मिलता है। GET /numbers या GET /pricing से फिर से सूची लें।
404 private_email_closed प्राइवेट इनबॉक्स बंद है क्योंकि इसका नंबर रद्द या रिफ़ंड कर दिया गया था। दोबारा प्रयास करने के लिए कुछ नहीं है।
409 - यह Idempotency-Key पहले ही किसी दूसरी body के साथ उपयोग हो चुकी है, या इसके साथ भेजा गया पहला अनुरोध अभी भी चल रहा है। नए अनुरोध के लिए नई कुंजी का उपयोग करें; चल रहे अनुरोध के लिए प्रतीक्षा करें और फिर से प्रयास करें।
422 insufficient_funds वॉलेट में कीमत चुकाने के लिए पर्याप्त राशि नहीं है। वॉलेट टॉप अप करें और फिर से प्रयास करें।
422 out_of_stock आपकी कीमत जाँच और खरीदारी के बीच बाज़ार में स्टॉक खत्म हो गया। GET /inventory फिर से जाँचें और कोई दूसरी अवधि या प्रकार चुनें।
422 invalid_duration उस देश और नंबर प्रकार के लिए यह अवधि उपलब्ध नहीं है। GET /pricing/{countryCode} फिर से लाएँ।
422 - सत्यापन विफल रहा (एक `errors` ऑब्जेक्ट हर फ़ील्ड का नाम बताता है) या किसी नियम ने कार्रवाई अस्वीकार कर दी, जैसे रिफ़ंड अवधि के बाहर रद्द करना। `message` पढ़ें; दोबारा प्रयास करने के बजाय अनुरोध ठीक करें।
429 - रेट लिमिट पूरी हो गई। Retry-After हेडर की प्रतीक्षा करें, फिर बैकऑफ़ के साथ दोबारा प्रयास करें।
503 purchases_paused पूरे प्लेटफ़ॉर्म पर नई खरीदारी रोक दी गई है। कोई शुल्क नहीं लिया गया; रिन्यूअल और रद्द करना अब भी काम करते हैं। Retry-After (60 s) के बाद फिर से प्रयास करें।
5xx - हमारी ओर से कुछ गड़बड़ हो गई। उसी Idempotency-Key के साथ फिर से प्रयास करें - आपसे कभी दो बार शुल्क नहीं लिया जाएगा।

रेट लिमिट

सीमाएँ हर कुंजी पर लागू होती हैं, और पैसे से जुड़ी कॉल पर इसके अलावा प्रति खाता एक सख्त सीमा होती है:

इस पर लागूसीमागिनती
सभी एंडपॉइंट60 / मिनटहर API key पर
खरीदें, रिन्यू करें, रद्द करें10 / मिनटहर अकाउंट पर, ऊपर दी गई सीमाओं के अलावा
GET /receive-sms60 / मिनटहर API key पर
GET /receive-sms30 / मिनटहर API key और फ़ोन नंबर पर
GET /receive-sms30 / मिनटहर IP पते पर

सीमा पार करने पर आपको 429 के साथ एक Retry-After हेडर (सेकंड में) मिलता है। कम से कम उतनी देर प्रतीक्षा करें, फिर jitter के साथ बैक ऑफ़ करें। जवाबों में X-RateLimit-Limit और X-RateLimit-Remaining भी होते हैं।

SMS का इंतज़ार कर रहे हैं? एक नंबर को अधिकतम हर 5 सेकंड में poll करें।

Idempotency

POST /numbers/buy, /renew और /cancel के लिए ज़रूरी है एक Idempotency-Key हेडर: हर नई कार्रवाई के लिए आपके द्वारा बनाया गया एक UUID। अगर नेटवर्क टूट जाए, तो वही अनुरोध उसी कुंजी के साथ भेजें - आपको मूल जवाब वापस मिलेगा (X-Idempotency-Replayed: true चिह्नित) और आपसे कभी दो बार शुल्क नहीं लिया जाएगा।

  • कुंजी न होने पर: 400। कुंजियाँ अधिकतम 128 वर्णों की होती हैं, जिनमें अक्षर, अंक और - _ . : हो सकते हैं
  • उसी कुंजी के साथ अलग बॉडी: 409। पहला अनुरोध चलते समय उसी कुंजी का उपयोग: 409 - थोड़ा रुकें और फिर से कोशिश करें।
  • कुंजियाँ हर खाते और एंडपॉइंट के लिए याद रखी जाती हैं। किसी दूसरी खरीदारी के लिए एक ही कुंजी दोबारा इस्तेमाल न करें।

पेजिनेशन

GET /receive-sms cursor पेजिनेशन इस्तेमाल करता है, सबसे नए पहले। meta.hasMore पढ़ें; जब तक यह true है, meta.nextCursor को cursor के रूप में, उसी phoneNumber के साथ, वापस भेजें। Cursor अपारदर्शी होते हैं - इन्हें न बनाएँ, न बदलें।

अगला पेज
GET https://api.temp-number.com/v1/receive-sms?phoneNumber=%2B14035551234&limit=50&cursor=eyJkYXRlIjoiMjAyNi0wNS0xMyJ9

स्वभाव से छोटी सूचियाँ (/numbers, /pricing) सब कुछ एक ही जवाब में लौटाती हैं; निजी इनबॉक्स page और per_page इस्तेमाल करता है।

स्वीकार्य उपयोग

यह API डेवलपर्स के लिए बनाया गया है: वेरिफ़िकेशन और OTP फ़्लो, ऑटोमेटेड ऑनबोर्डिंग, QA और सिस्टम टेस्टिंग, और कोई भी प्रोडक्ट जिसे बड़े पैमाने पर इनबाउंड SMS या फ़ोन नंबर चाहिए।

  • इसका उपयोग केवल वैध वेरिफ़िकेशन, डेवलपमेंट और टेस्टिंग के लिए करें।
  • कोई स्कैम, स्पैम, धोखाधड़ी या छल नहीं। स्कैम या अन्य दुरुपयोग के लिए इस्तेमाल किए गए नंबरों पर खाते को तुरंत और बिना सूचना के बैन कर दिया जाता है, संबंधित नंबर रद्द कर दिए जाते हैं, और कोई रिफ़ंड नहीं मिलता।
  • विनियमित या पहचान से जुड़े खातों के लिए नहीं। हमारे साझा, अस्थायी नंबर बैंकिंग, भुगतान, क्रिप्टोकरेंसी, सरकारी या ऐसी अन्य सेवाओं के SMS वेरिफ़िकेशन को सपोर्ट नहीं करते जो आपकी कानूनी पहचान सत्यापित करती हैं (KYC/AML) - उनके लिए अपना निजी मोबाइल नंबर इस्तेमाल करें।
हम दुरुपयोग पर नज़र रखते हैं। पूरी शर्तें हमारी सेवा की शर्तों में हैं।

API रेफ़रेंस

हर लाइव /v1 एंडपॉइंट। अनुरोध दाईं ओर आपकी भाषा में हैं; जवाब असली संरचना में हैं।

अकाउंट

अपना वॉलेट बैलेंस और सेटलमेंट मुद्रा देखें।

GET /v1/account

अकाउंट बैलेंस पाएँ

उपलब्ध वॉलेट बैलेंस और उसकी मुद्रा लौटाता है। खरीदारी से पहले इसे जाँचें ताकि आप साफ़ "टॉप अप करें" संदेश के साथ पहले ही रुक सकें।

रिस्पॉन्स फ़ील्ड
  • balancenumber

    उपलब्ध वॉलेट बैलेंस।

  • currencystring

    सेटलमेंट मुद्रा, USD.

त्रुटियाँ
  • 401कुंजी नहीं है या अमान्य है।
curl --request GET "https://api.temp-number.com/v1/account" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json"
रिस्पॉन्स
{
  "success": true,
  "balance": 124.50,
  "currency": "USD"
}

कीमतें और स्टॉक

लाइव बाज़ार, हर अवधि के लिए आपकी चुकाई जाने वाली सटीक कीमत और रियल-टाइम स्टॉक देखें।

देश का मूल्य ऑब्जेक्ट

एक देश और वहाँ खरीदे जा सकने वाले सभी पैकेज। price वह अंतिम राशि है जो आपके वॉलेट से ली जाती है; अपस्ट्रीम लागत कभी नहीं दिखाई जाती।

फ़ील्ड
  • country_codestring

    ISO 3166-1 alpha-2 कोड, जैसे US.

  • country_namestring

    प्रदर्शित नाम।

  • packages[].number_typeenum

    voip या non_voip।

  • packages[].durationenum

    खरीदने के लिए भेजी जाने वाली कुंजी: halfDay, oneDay, oneWeek, oneMonth, threeMonths, sixMonths या oneYear. हर देश के अपने विकल्प होते हैं।

  • packages[].duration_labelstring

    पढ़ने योग्य लेबल, जैसे "1 महीना"।

  • packages[].pricenumber

    USD में अंतिम कीमत।

  • packages[].original_pricenumber | null

    छूट से पहले की कीमत, जब छूट लागू हो।

  • packages[].updated_atnull

    आरक्षित।

object
{
  "country_code": "US",
  "country_name": "United States",
  "packages": [
    {
      "number_type": "voip",
      "duration": "oneMonth",
      "duration_label": "1 Month",
      "price": 4.99,
      "original_price": 5.99,
      "updated_at": null
    }
  ]
}
GET /v1/pricing

सभी देशों की कीमतें

पूरा लाइव कैटलॉग: देश के मूल्य ऑब्जेक्ट की सूची। price फ़ील्ड USD में उपयोगकर्ता के लिए अंतिम दर है, ठीक वही जो आपके वॉलेट से लिया जाता है।

लौटाता है

data में देश के मूल्य ऑब्जेक्ट की सूची, साथ में meta.count।

त्रुटियाँ
  • 401कुंजी नहीं है या अमान्य है।
curl --request GET "https://api.temp-number.com/v1/pricing" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json"
रिस्पॉन्स
{
  "success": true,
  "data": [
    {
      "country_code": "US",
      "country_name": "United States",
      "packages": [
        {
          "number_type": "voip",
          "duration": "oneMonth",
          "duration_label": "1 Month",
          "price": 4.99,
          "original_price": 5.99,
          "updated_at": null
        },
        {
          "number_type": "voip",
          "duration": "threeMonths",
          "duration_label": "3 Months",
          "price": 12.99,
          "original_price": null,
          "updated_at": null
        }
      ]
    }
  ],
  "meta": { "count": 1 }
}
GET /v1/pricing/{countryCode}

एक देश की कीमतें पाएँ

किसी एक देश की लाइव कीमतें। 404 का मतलब है कि उस देश के लिए अभी कोई सक्रिय रूट नहीं है: इसे अस्थायी "स्टॉक खत्म" मानें, "कभी नहीं बिकता" नहीं।

पैरामीटर
  • countryCode string path ज़रूरी

    ISO 3166-1 alpha-2 देश कोड, जैसे US, GB, CA.

लौटाता है

data में देश का एक मूल्य ऑब्जेक्ट।

त्रुटियाँ
  • 404उस देश के लिए अभी कोई सक्रिय रूट नहीं है।
curl --request GET "https://api.temp-number.com/v1/pricing/GB" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json"
रिस्पॉन्स
{
  "success": true,
  "data": {
    "country_code": "GB",
    "country_name": "United Kingdom",
    "packages": [
      {
        "number_type": "voip",
        "duration": "oneMonth",
        "duration_label": "1 Month",
        "price": 5.49,
        "original_price": null,
        "updated_at": null
      }
    ]
  }
}
GET /v1/inventory

स्टॉक जाँचें

किसी देश और अवधि का रियल-टाइम स्टॉक, ताकि आप किसी के क्लिक करने से पहले ही खरीदें बटन बंद कर सकें। types[] में सभी प्रकार साथ-साथ पाने के लिए number_type छोड़ दें। हरा परिणाम एक मज़बूत संकेत है, लेकिन अंतिम जाँच खरीदारी ही है।

पैरामीटर
  • country_code string query ज़रूरी

    ISO 3166-1 alpha-2 देश कोड।

  • duration enum query वैकल्पिक

    GET /pricing/{countryCode} से एक अवधि कुंजी। रूट के डिफ़ॉल्ट के लिए इसे छोड़ दें।

    इनमें से एक halfDayoneDayoneWeekoneMonththreeMonthssixMonthsoneYear
  • number_type enum query वैकल्पिक

    जाँच को एक प्रकार तक सीमित करें। सभी प्रकार देखने के लिए इसे छोड़ दें।

    इनमें से एक voipnon_voip
रिस्पॉन्स फ़ील्ड
  • stockinteger | null

    उपलब्ध नंबर (number_type न देने पर types[] का कुल योग)।

  • availableboolean

    true, जब कम से कम एक नंबर खरीदा जा सकता हो।

  • statusstring

    पढ़ने योग्य लेबल: स्टॉक में, स्टॉक खत्म, जल्द आ रहा है…

  • types[]array

    केवल तब जब number_type छोड़ा गया हो: बाज़ार में बिकने वाले हर प्रकार के लिए number_type, stock, available, status.

त्रुटियाँ
  • 422इस चयन के लिए कुछ भी बिक्री पर नहीं है; details में स्टॉक फ़ील्ड होते हैं।
curl --request GET "https://api.temp-number.com/v1/inventory?country_code=US&duration=oneMonth" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json"
रिस्पॉन्स
{
  "success": true,
  "data": {
    "country_code": "US",
    "duration": "oneMonth",
    "number_type": null,
    "stock": 47,
    "available": true,
    "status": "In Stock",
    "types": [
      { "number_type": "voip", "stock": 0, "available": false, "status": "Out of Stock" },
      { "number_type": "non_voip", "stock": 47, "available": true, "status": "In Stock" }
    ]
  }
}

नंबर

अपने प्राइवेट नंबरों की सूची देखें, उन्हें खरीदें, रिन्यू करें और रद्द करें। पैसों से जुड़ी कॉल idempotent हैं और दोबारा भेजने पर सुरक्षित हैं।

नंबर ऑब्जेक्ट

आपके अकाउंट का एक नंबर। खरीदना, रिन्यू करना और रद्द करना meta में पैसों का सारांश भी लौटाते हैं: charged (या refunded), currency और wallet_balance_after।

फ़ील्ड
  • idinteger

    इसे /numbers/{id}/… कॉल में उपयोग करें। Webhook इसे number.rentalId के रूप में भेजते हैं।

  • phone_numberstring

    E.164, जैसे +14035551234.

  • country_codestring | null

    ISO 3166-1 alpha-2.

  • country_namestring

    प्रदर्शित नाम।

  • number_typeenum

    voip या non_voip।

  • statusenum

    active, expired, cancelled या refunded।

  • purchase_datestring

    ISO 8601, UTC.

  • expire_datestring

    ISO 8601, UTC. इसके बाद नंबर पर SMS आना बंद हो जाता है और इसे रिन्यू नहीं किया जा सकता।

पुराने इंटीग्रेशन के लिए अब भी भेजे जाने वाले अप्रचलित उपनाम: country, provider, purchased_at और expires_at (epoch मिलीसेकंड)। इन पर निर्भर न रहें।

object
{
  "id": 1482,
  "phone_number": "+14035551234",
  "country_code": "US",
  "country_name": "United States",
  "number_type": "voip",
  "status": "active",
  "purchase_date": "2026-05-13T17:42:09Z",
  "expire_date": "2026-06-13T17:42:09Z"
}
GET /v1/numbers

अपने नंबरों की सूची

आपके अकाउंट के सभी नंबर, सबसे नए पहले। रिन्यूअल रिमाइंडर के लिए status=expiring_soon (समाप्ति से 10 दिन के भीतर वाले सक्रिय नंबर) का उपयोग करें।

पैरामीटर
  • status enum query वैकल्पिक

    जीवनचक्र फ़िल्टर। डिफ़ॉल्ट all.

    इनमें से एक allactiveexpiring_soonexpiredcancelled
लौटाता है

data में नंबर ऑब्जेक्ट की सूची; meta.count और meta.status।

त्रुटियाँ
  • 401कुंजी नहीं है या अमान्य है।
curl --request GET "https://api.temp-number.com/v1/numbers?status=expiring_soon" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json"
रिस्पॉन्स
{
  "success": true,
  "data": [
    {
      "id": 1482,
      "phone_number": "+14035551234",
      "country_code": "US",
      "country_name": "United States",
      "number_type": "voip",
      "status": "active",
      "purchase_date": "2026-05-13T17:42:09Z",
      "expire_date": "2026-06-13T17:42:09Z"
    }
  ],
  "meta": { "count": 1, "status": "expiring_soon" }
}
POST /v1/numbers/buy Idempotency-Key ज़रूरी है

नंबर खरीदें

एक नया प्राइवेट नंबर आवंटित करता है और एक ही अटॉमिक चरण में आपके वॉलेट से शुल्क लेता है। अगर शुल्क लेने के बाद डिलीवरी विफल हो जाए, तो शुल्क वापस कर दिया जाता है: ऐसा कभी नहीं होगा कि आपने भुगतान किया और नंबर नहीं मिला। जवाब में लिया गया शुल्क और बाद का बैलेंस दिखाया जाता है।

पैरामीटर
  • country_code string body ज़रूरी

    GET /pricing से कोई देश।

  • duration enum body ज़रूरी

    उस देश के packages[] से एक अवधि कुंजी - हर देश के अपने विकल्प होते हैं।

    इनमें से एक halfDayoneDayoneWeekoneMonththreeMonthssixMonthsoneYear
  • number_type enum body वैकल्पिक

    रूट के डिफ़ॉल्ट का उपयोग करने के लिए इसे छोड़ दें।

    इनमें से एक voipnon_voip
  • Idempotency-Key string header ज़रूरी

    एक UUID, हर खरीदारी के लिए नया, दोबारा प्रयास करने पर वही।

लौटाता है

data में नया नंबर ऑब्जेक्ट; meta.charged, meta.currency, meta.wallet_balance_after.

त्रुटियाँ
  • 422insufficient_fundsवॉलेट में कीमत चुकाने के लिए पर्याप्त राशि नहीं है।
  • 422out_of_stockआपकी स्टॉक जाँच के बाद स्टॉक खत्म हो गया।
  • 422invalid_durationइस देश/प्रकार के लिए यह अवधि उपलब्ध नहीं है।
  • 403kyc_requiredपहले पहचान सत्यापन ज़रूरी है। कोई शुल्क नहीं लिया गया।
  • 503purchases_pausedपूरे प्लेटफ़ॉर्म पर खरीदारी रोकी गई है। Retry-After: 60.
curl --request POST "https://api.temp-number.com/v1/numbers/buy" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $(uuidgen)" \
  --data '{"country_code":"US","duration":"oneMonth","number_type":"voip"}'
रिस्पॉन्स
{
  "success": true,
  "data": {
    "id": 1482,
    "phone_number": "+14035551234",
    "country_code": "US",
    "country_name": "United States",
    "number_type": "voip",
    "status": "active",
    "purchase_date": "2026-05-13T17:42:09Z",
    "expire_date": "2026-06-13T17:42:09Z"
  },
  "meta": {
    "charged": 4.99,
    "currency": "USD",
    "wallet_balance_after": 119.51
  }
}
POST /v1/numbers/{id}/renew Idempotency-Key ज़रूरी है

नंबर रिन्यू करें

चुने गए पैकेज के अनुसार नंबर की अवधि बढ़ाता है। नई अवधि मौजूदा समाप्ति तिथि में जोड़ी जाती है, इसलिए जल्दी रिन्यू करने में कुछ नहीं खोता। कीमत साइट की मौजूदा दर है, जिसकी गणना हमारी ओर से होती है। समाप्त हो चुके नंबर रिन्यू नहीं किए जा सकते: नया नंबर खरीदें।

पैरामीटर
  • id integer path ज़रूरी

    GET /numbers से नंबर id।

  • package enum body वैकल्पिक

    रिन्यूअल की अवधि। डिफ़ॉल्ट oneMonth. (duration को पुराने उपनाम के रूप में स्वीकार किया जाता है।)

    इनमें से एक oneMonththreeMonthssixMonthsoneYear
  • Idempotency-Key string header ज़रूरी

    एक UUID, हर रिन्यूअल के लिए नया, दोबारा प्रयास करने पर वही।

लौटाता है

data में अपडेट किया गया नंबर ऑब्जेक्ट; meta.charged, meta.currency, meta.wallet_balance_after.

त्रुटियाँ
  • 404यह नंबर आपके अकाउंट में नहीं है।
  • 422insufficient_fundsवॉलेट में रिन्यूअल के लिए पर्याप्त राशि नहीं है।
  • 422समाप्त, रद्द या रिन्यू के योग्य नहीं।
curl --request POST "https://api.temp-number.com/v1/numbers/1482/renew" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $(uuidgen)" \
  --data '{"package":"threeMonths"}'
रिस्पॉन्स
{
  "success": true,
  "data": {
    "id": 1482,
    "phone_number": "+14035551234",
    "country_code": "US",
    "country_name": "United States",
    "number_type": "voip",
    "status": "active",
    "purchase_date": "2026-05-13T17:42:09Z",
    "expire_date": "2026-09-13T17:42:09Z"
  },
  "meta": {
    "charged": 12.99,
    "currency": "USD",
    "wallet_balance_after": 106.52
  }
}
POST /v1/numbers/{id}/cancel Idempotency-Key ज़रूरी है

रिफ़ंड के लिए नंबर रद्द करें

नंबर को छोड़ता है और उसकी पूरी कीमत आपके वॉलेट में रिफ़ंड करता है। यह केवल खरीद के 15 से 120 मिनट के बीच, नंबर सक्रिय रहते हुए और उस पर कोई SMS आने से पहले संभव है। इन नियमों के बाहर कॉल 422 के साथ अस्वीकार हो जाती है और कुछ नहीं बदलता; बहुत जल्दी होने पर details.seconds_until_open बताता है कि कितनी प्रतीक्षा करनी है।

पैरामीटर
  • id integer path ज़रूरी

    GET /numbers से नंबर id।

  • Idempotency-Key string header ज़रूरी

    एक UUID, दोबारा प्रयास करने पर वही।

लौटाता है

data में नंबर ऑब्जेक्ट (status cancelled); meta.refunded, meta.currency, meta.wallet_balance_after.

त्रुटियाँ
  • 404यह नंबर आपके अकाउंट में नहीं है।
  • 422बहुत जल्दी (15 मिनट से कम), बहुत देर (120 मिनट से अधिक), SMS पहले ही आ चुका है, या सक्रिय नहीं है।
curl --request POST "https://api.temp-number.com/v1/numbers/1482/cancel" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json" \
  --header "Idempotency-Key: $(uuidgen)"
रिस्पॉन्स
{
  "success": true,
  "data": {
    "id": 1482,
    "phone_number": "+14035551234",
    "country_code": "US",
    "country_name": "United States",
    "number_type": "voip",
    "status": "cancelled",
    "purchase_date": "2026-05-13T17:42:09Z",
    "expire_date": "2026-06-13T17:42:09Z"
  },
  "meta": {
    "refunded": 4.99,
    "currency": "USD",
    "wallet_balance_after": 124.50
  }
}

SMS

अपने नंबरों पर आने वाले SMS पढ़ें। आपको मूल टेक्स्ट मिलता है; कोड निकालना आपके ऊपर है।

SMS संदेश ऑब्जेक्ट

एक प्राप्त SMS, जैसा GET /numbers/{id}/sms लौटाता है। (GET /receive-sms एक camelCase रूप का उपयोग करता है, जो उसी एंडपॉइंट पर दिखाया गया है।)

फ़ील्ड
  • idinteger

    संदेश id।

  • fromstring

    प्रेषक: कोई फ़ोन नंबर या WhatsApp जैसा कोई नाम।

  • bodystring

    संदेश का पूरा टेक्स्ट।

  • received_atstring

    ISO 8601, UTC.

अब भी भेजे जाने वाले अप्रचलित उपनाम: sender (= from) और message (= body)।

object
{
  "id": 9912,
  "from": "+18005550199",
  "body": "Your code is 432901",
  "received_at": "2026-05-13T17:43:14Z"
}
GET /v1/numbers/{id}/sms

नंबर और उसके SMS पाएँ

एक नंबर और उस पर आए सभी SMS, सबसे नए पहले। "इस नंबर का विवरण" दृश्य के लिए और कोड की प्रतीक्षा करते समय किसी एक नंबर को पोल करने के लिए सबसे अच्छा। जो id आपकी नहीं हैं उन पर 404 मिलता है।

पैरामीटर
  • id integer path ज़रूरी

    GET /numbers से नंबर id।

लौटाता है

data.number (एक नंबर ऑब्जेक्ट) और data.messages (SMS मैसेज ऑब्जेक्ट); meta.count।

त्रुटियाँ
  • 404यह नंबर आपके अकाउंट में नहीं है।
curl --request GET "https://api.temp-number.com/v1/numbers/1482/sms" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json"
रिस्पॉन्स
{
  "success": true,
  "data": {
    "number": {
      "id": 1482,
      "phone_number": "+14035551234",
      "country_code": "US",
      "country_name": "United States",
      "number_type": "voip",
      "status": "active",
      "purchase_date": "2026-05-13T17:42:09Z",
      "expire_date": "2026-06-13T17:42:09Z"
    },
    "messages": [
      {
        "id": 9912,
        "from": "+18005550199",
        "body": "Your code is 432901",
        "received_at": "2026-05-13T17:43:14Z"
      }
    ]
  },
  "meta": { "count": 1 }
}
GET /v1/receive-sms

फ़ोन नंबर से SMS प्राप्त करें

आपके अपने किसी नंबर के SMS, कर्सर-आधारित पेजिनेशन के साथ, जिन्हें id के बजाय फ़ोन नंबर से पहचाना जाता है। ज़्यादा SMS वाले इनबॉक्स के लिए सबसे अच्छा। जो नंबर आपका नहीं है उस पर 403 मिलता है।

पैरामीटर
  • phoneNumber string query ज़रूरी

    E.164 या केवल अंक, जैसे +14035551234. + को URL-encode करें।

  • limit integer query वैकल्पिक

    पेज का आकार 1-100. डिफ़ॉल्ट 50.

  • cursor string query वैकल्पिक

    पिछले पेज से meta.nextCursor।

रिस्पॉन्स फ़ील्ड
  • data.messages[].idinteger

    संदेश id।

  • data.messages[].fromstring

    प्रेषक।

  • data.messages[].tostring

    आपका नंबर।

  • data.messages[].messagestring

    पूरा टेक्स्ट।

  • data.messages[].receivedAtstring

    ISO 8601.

  • meta.hasMore / nextCursorboolean / string | null

    अगले पेज के लिए nextCursor को cursor के रूप में भेजें।

त्रुटियाँ
  • 403यह नंबर आपके अकाउंट में नहीं है।
  • 422phoneNumber मौजूद नहीं है या अमान्य है।
curl --request GET "https://api.temp-number.com/v1/receive-sms?phoneNumber=%2B14035551234&limit=50" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json"
रिस्पॉन्स
{
  "success": true,
  "data": {
    "phoneNumber": "+14035551234",
    "purchaseStatus": "active",
    "messages": [
      {
        "id": 1842,
        "from": "WhatsApp",
        "to": "+14035551234",
        "message": "Your verification code is 483920.",
        "receivedAt": "2026-05-13T17:43:14+00:00"
      }
    ]
  },
  "meta": {
    "count": 1,
    "pageSize": 50,
    "hasMore": false,
    "nextCursor": null,
    "prevCursor": null,
    "requestedAt": "2026-05-13T17:43:20+00:00"
  }
}

प्राइवेट ईमेल

हर प्राइवेट नंबर के लिए एक मुफ़्त, केवल-प्राप्ति वाला [email protected] इनबॉक्स। हर नंबर के लिए एक पता।

प्राइवेट ईमेल ऑब्जेक्ट

किसी एक नंबर से जुड़ा इनबॉक्स।

फ़ील्ड
  • addressstring | null

    पता, या पता लेने से पहले null.

  • statusenum

    active या none।

  • unread_countinteger

    अपठित ईमेल।

  • created_atstring | null

    जब पता लिया गया।

  • eligibleboolean

    true, जब नंबर अभी पता ले सकता हो।

  • linked_numberstring

    वह फ़ोन नंबर जिससे यह जुड़ा है।

  • domainstring

    privnum.com

  • suggestionsstring[]

    योग्य होने पर नाम के सुझाव।

object
{
  "address": "[email protected]",
  "status": "active",
  "unread_count": 2,
  "created_at": "2026-07-03T10:15:00+00:00",
  "eligible": false,
  "linked_number": "+14035551234",
  "domain": "privnum.com",
  "suggestions": []
}
GET /v1/numbers/{id}/private-email

प्राइवेट ईमेल पाएँ

किसी नंबर का पता, या पता लेने से पहले, यह कि क्या उसे पता मिल सकता है और कुछ नाम सुझाव।

पैरामीटर
  • id integer path ज़रूरी

    GET /numbers से नंबर id।

लौटाता है

data में एक प्राइवेट ईमेल ऑब्जेक्ट।

त्रुटियाँ
  • 404यह नंबर आपके अकाउंट में नहीं है।
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json"
रिस्पॉन्स
{
  "success": true,
  "data": {
    "address": null,
    "status": "none",
    "unread_count": 0,
    "created_at": null,
    "eligible": true,
    "linked_number": "+14035551234",
    "domain": "privnum.com",
    "suggestions": ["alex.smith", "alex.smith42"]
  }
}
GET /v1/numbers/{id}/private-email/availability

नाम जाँचें

नाम लेने से पहले लाइव जाँचें कि वह मान्य और उपलब्ध है।

पैरामीटर
  • id integer path ज़रूरी

    GET /numbers से नंबर id।

  • local_part string query ज़रूरी

    @ से पहले का भाग: 3-64 अक्षर, अंक, बिंदु, डैश या अंडरस्कोर।

रिस्पॉन्स फ़ील्ड
  • availableboolean

    true, जब आप इसे ले सकते हों।

  • reasonenum | null

    too_short, too_long, invalid, reserved या taken।

त्रुटियाँ
  • 404यह नंबर आपके अकाउंट में नहीं है।
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email/availability?local_part=alex.smith" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json"
रिस्पॉन्स
{
  "success": true,
  "data": {
    "local_part": "alex.smith",
    "address": "[email protected]",
    "available": true,
    "reason": null,
    "message": "Available"
  }
}
POST /v1/numbers/{id}/private-email

पता प्राप्त करें

सक्रिय नंबर को उसका पता देता है। मुफ़्त, हर नंबर के लिए एक, और लिया गया पता कभी किसी और को नहीं दिया जाता।

पैरामीटर
  • id integer path ज़रूरी

    GET /numbers से नंबर id।

  • local_part string body ज़रूरी

    वह नाम जो आपने जाँचा।

लौटाता है

data में प्राइवेट ईमेल ऑब्जेक्ट।

त्रुटियाँ
  • 404यह आपका नंबर नहीं है, या अभी इसका कोई पता नहीं है।
  • 422नाम पहले से लिया गया या अमान्य है (details.reason), नंबर के पास पहले से पता है, या वह सक्रिय नहीं है।
curl --request POST "https://api.temp-number.com/v1/numbers/1482/private-email" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{"local_part":"alex.smith"}'
रिस्पॉन्स
{
  "success": true,
  "data": {
    "address": "[email protected]",
    "status": "active",
    "unread_count": 0,
    "created_at": "2026-07-03T10:15:00+00:00",
    "eligible": false,
    "linked_number": "+14035551234",
    "domain": "privnum.com",
    "suggestions": []
  }
}
GET /v1/numbers/{id}/private-email/inbox

ईमेल की सूची

ईमेल सारांश, सबसे नए पहले, पेज-आधारित पेजिनेशन और शीर्ष स्तर पर अपठित संख्या के साथ।

पैरामीटर
  • id integer path ज़रूरी

    GET /numbers से नंबर id।

  • page integer query वैकल्पिक

    पेज नंबर। डिफ़ॉल्ट 1.

  • per_page integer query वैकल्पिक

    1-100. डिफ़ॉल्ट 25.

रिस्पॉन्स फ़ील्ड
  • data[]array

    id, from_email, from_name, subject, preview, attachment_count, is_read, received_at।

  • metaobject

    current_page, per_page, total, last_page।

  • unread_countinteger

    शीर्ष स्तर पर, data के बगल में।

त्रुटियाँ
  • 404यह आपका नंबर नहीं है, या अभी इसका कोई पता नहीं है।
  • 404private_email_closedनंबर रद्द या रिफ़ंड कर दिया गया था।
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email/inbox?page=1&per_page=25" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json"
रिस्पॉन्स
{
  "success": true,
  "data": [
    {
      "id": 77,
      "from_email": "[email protected]",
      "from_name": "Example Billing",
      "subject": "Your receipt",
      "preview": "Thanks for your order…",
      "attachment_count": 1,
      "is_read": false,
      "received_at": "2026-07-04T08:01:12+00:00"
    }
  ],
  "meta": { "current_page": 1, "per_page": 25, "total": 1, "last_page": 1 },
  "unread_count": 1
}
GET /v1/numbers/{id}/private-email/inbox/{messageId}/body

ईमेल पढ़ें

पूरा ईमेल (HTML और टेक्स्ट) उसके अटैचमेंट की सूची के साथ। इसे पढ़ने पर यह पढ़ा हुआ मार्क हो जाता है।

पैरामीटर
  • id integer path ज़रूरी

    GET /numbers से नंबर id।

  • messageId integer path ज़रूरी

    इनबॉक्स सूची से ईमेल id।

त्रुटियाँ
  • 404यह आपका नंबर नहीं है, या अभी इसका कोई पता नहीं है।
  • 404private_email_closedनंबर रद्द या रिफ़ंड कर दिया गया था।
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/body" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json"
रिस्पॉन्स
{
  "success": true,
  "data": {
    "id": 77,
    "subject": "Your receipt",
    "from_email": "[email protected]",
    "from_name": "Example Billing",
    "received_at": "2026-07-04T08:01:12+00:00",
    "html": "<p>Thanks for your order…</p>",
    "text": "Thanks for your order…",
    "attachments": [
      { "index": 0, "filename": "receipt.pdf", "content_type": "application/pdf", "size_bytes": 48211 }
    ]
  }
}
GET /v1/numbers/{id}/private-email/inbox/{messageId}/attachments/{index}

अटैचमेंट डाउनलोड करें

मूल फ़ाइल, अपने Content-Type और फ़ाइल नाम के साथ। index ईमेल के attachments[] से आता है।

पैरामीटर
  • id integer path ज़रूरी

    GET /numbers से नंबर id।

  • messageId integer path ज़रूरी

    इनबॉक्स सूची से ईमेल id।

  • index integer path ज़रूरी

    “ईमेल पढ़ें” से attachments[].index।

त्रुटियाँ
  • 404यह आपका नंबर नहीं है, या अभी इसका कोई पता नहीं है।
  • 404private_email_closedनंबर रद्द या रिफ़ंड कर दिया गया था।
  • 404उस इंडेक्स पर कोई अटैचमेंट नहीं है।
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/attachments/0" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --output receipt.pdf
रिस्पॉन्स
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename=receipt.pdf

<binary file>
DELETE /v1/numbers/{id}/private-email/inbox/{messageId}

ईमेल हटाएँ

ईमेल और उसके अटैचमेंट हटा देता है।

पैरामीटर
  • id integer path ज़रूरी

    GET /numbers से नंबर id।

  • messageId integer path ज़रूरी

    इनबॉक्स सूची से ईमेल id।

त्रुटियाँ
  • 404यह आपका नंबर नहीं है, या अभी इसका कोई पता नहीं है।
  • 404private_email_closedनंबर रद्द या रिफ़ंड कर दिया गया था।
curl --request DELETE "https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77" \
  --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
  --header "Accept: application/json"
रिस्पॉन्स
{
  "success": true,
  "data": null
}

AI और MCP

किसी AI असिस्टेंट को सीधे आपका खाता इस्तेमाल करने दें, या कोडिंग एजेंट को API पर बनाने के लिए ज़रूरी सब कुछ दें।

MCP सर्वर

REST API के साथ-साथ हम एक Model Context Protocol सर्वर भी चलाते हैं। इसे Claude, ChatGPT या अपने एडिटर से जोड़ें और असिस्टेंट नेटिव टूल्स के रूप में कीमतें और स्टॉक देख सकता है, नंबर खरीद सकता है और उसके SMS पढ़ सकता है - आपकी तरफ़ से कोई कोड नहीं। MCP में नए हैं? MCP सर्वर का परिचय से शुरू करें।

एंडपॉइंट
MCP endpoint · streamable HTTP
https://mcp.temp-number.com/mcp

साइन-इन कैसे काम करता है

  • URL को अपने AI ऐप में जोड़ें। यह आपको Temp Number पर अपने खाते से साइन इन करने (PKCE के साथ OAuth 2.1) के लिए भेजता है - कोई key कॉपी करने की ज़रूरत नहीं।
  • सहमति स्क्रीन पर आप चुनते हैं कि असिस्टेंट क्या कर सकता है। बैलेंस, कीमतें, आपके नंबर और उनके SMS पढ़ना हमेशा शामिल रहता है। Allow purchases - आपके वॉलेट से खरीदना, रिन्यू करना और रद्द करना - तब तक बंद रहता है जब तक आप इसे टिक न करें।
  • हर कनेक्शन Dashboard → MCP Server → Connected apps में दिखता है, जहाँ आप इसे कभी भी डिस्कनेक्ट कर सकते हैं।
  • key पसंद है (CI, स्क्रिप्ट, headless एजेंट)? उसी पेज पर एक MCP key बनाएँ और उसे Authorization: Bearer <key> के रूप में भेजें। MCP keys और REST API keys एक-दूसरे की जगह इस्तेमाल नहीं हो सकतीं।

टूल्स

टूलयह क्या करता है"Allow purchases" ज़रूरी है
get-balanceप्रमाणित अकाउंट का वॉलेट बैलेंस और बिलिंग करेंसी प्राप्त करें।नहीं
get-pricingसभी देशों या किसी एक ISO देश कोड के लिए सक्रिय प्राइसिंग कैटलॉग लौटाएँ।नहीं
get-inventoryकिसी देश, अवधि और वैकल्पिक नंबर प्रकार के लिए लाइव इन्वेंटरी की उपलब्धता देखें।नहीं
purchase-numberवॉलेट फ़ंड से प्रमाणित अकाउंट के लिए एक प्राइवेट नंबर खरीदें।हाँ
list-active-numbersप्रमाणित अकाउंट के स्वामित्व वाले नंबर लौटाएँ, वैकल्पिक रूप से स्टेटस के अनुसार फ़िल्टर करके।नहीं
check-smsप्रमाणित अकाउंट के स्वामित्व वाले खरीदे गए नंबर ID के SMS मैसेज प्राप्त करें।नहीं
renew-numberवैकल्पिक अवधि पैकेज का इस्तेमाल करके ID से खरीदा गया नंबर रिन्यू करें।हाँ
cancel-numberID से खरीदा गया नंबर कैंसिल करें और लागू होने वाला वॉलेट रिफ़ंड लौटाएँ।हाँ

अपना AI टूल कनेक्ट करें

अपना ऐप चुनें। ज़्यादातर एक क्लिक में कनेक्ट हो जाते हैं: आप Temp Number में साइन इन करते हैं, टिक करते हैं कि असिस्टेंट क्या कर सकता है, और Allow पर क्लिक करते हैं।

Claude - claude.ai, डेस्कटॉप और मोबाइल

कुछ भी इंस्टॉल नहीं करना। ब्राउज़र, डेस्कटॉप ऐप और मोबाइल पर काम करता है।

  1. Add to Claude पर क्लिक करें। Claude खुलेगा जिसमें Temp Number और उसका URL पहले से भरे होंगे। Add पर क्लिक करें।
  2. Connect पर क्लिक करें, Temp Number में साइन इन करें, चुनें कि Claude खरीदारी कर सकता है या नहीं, और Allow पर क्लिक करें।
  3. किसी भी चैट में + मेनू → Connectors खोलें और Temp Number चालू करें। आज़माएँ: "एक महीने के लिए US नंबर की कीमत क्या है?"
Team और Enterprise: कोई owner Organization settings → Connectors में connector एक बार जोड़ता है। फिर हर सदस्य अपने Temp Number खाते से साइन इन करता है, ताकि हर कोई अपने ही वॉलेट से खर्च करे।

बटन नहीं दिख रहा? Claude में Customize → Connectors → Add custom connector पर जाएँ और MCP endpoint पेस्ट करें। जिन संगठनों के पास Claude का request-header विकल्प है, वे साइन इन करने के बजाय MCP key को Authorization: Bearer <key> के रूप में भेज सकते हैं।

llms.txt और एजेंट प्रॉम्प्ट

AI कोडिंग असिस्टेंट के साथ बना रहे हैं? उसे नीचे दिया गया संदर्भ दें और वह API को एक ही बार में सही तरीके से इंटीग्रेट कर सकता है - auth, idempotency और rate limits समेत।

llms.txt OpenAPI spec
prompt.md
You are integrating the Temp Number REST API. Read the full, machine-readable reference before writing any code:

- API reference (llms.txt): https://temp-number.com/developers/llms.txt
- OpenAPI spec: https://api.temp-number.com/api.json
- Base URL: https://api.temp-number.com/v1
- MCP server (for AI agents that call tools directly): https://mcp.temp-number.com/mcp - sign in with OAuth, or send an MCP key as a Bearer token.

Rules: authenticate every request with `Authorization: Bearer <YOUR_API_KEY>` (created in the dashboard → API Access) and keep the key in an environment variable, never in code; send and accept JSON over HTTPS; send a unique `Idempotency-Key` (UUID) header on every POST that buys, renews or cancels - it is required, and retries must reuse the same key; branch on the `code` field of error responses, not on the message text; on HTTP 429 or 503, wait for the `Retry-After` header. All prices are final USD.

Task: <describe what you want to build - e.g. "buy a US number, wait for the verification SMS, then cancel it if it never arrives">.
https://temp-number.com/developers/llms.txt हर endpoint का हमेशा अप-टू-डेट, सादा-टेक्स्ट सारांश है; OpenAPI spec टाइप्ड अनुबंध है। दोनों API के साथ अपडेट होते हैं।

संसाधन

क्या बदला है, और मदद कहाँ मिलेगी।

चेंजलॉग

केवल जोड़ने वाले बदलाव - /v1 से कुछ भी हटाया नहीं गया है।

  • NewMCP: अपने Temp Number अकाउंट से साइन इन करें

    एक क्लिक में "Add to Claude", साथ ही ChatGPT, Claude Code, Codex, Cursor और VS Code, बिना कोई कुंजी कॉपी किए। सहमति स्क्रीन पर आप तय करते हैं कि AI खर्च कर सकता है या नहीं।

  • Docsडॉक्स का नया ठिकाना

    क्विकस्टार्ट, खोज, और हर उदाहरण cURL, Node.js, Python और PHP में। त्रुटियाँ, रेट लिमिट और रिफ़ंड अब लाइव API से बिल्कुल मेल खाते हैं।

  • Newपूरी साइट के लिए llms.txt

    AI असिस्टेंट के लिए सेवा का सादा-टेक्स्ट नक्शा, जो एजेंट-के-लिए-तैयार API संदर्भ से लिंक करता है।

  • Newअपना AI टूल कनेक्ट करें

    Claude Code, Codex, Cursor और VS Code के लिए सेटअप, Cursor और VS Code के लिए एक-क्लिक इंस्टॉल लिंक के साथ।

  • NewOpenAPI spec

    मशीन-पठनीय विवरण https://api.temp-number.com/api.json पर उपलब्ध है।

  • Improvedऑब्जेक्ट संदर्भ से मेल खाते हैं

    नंबर और SMS में ISO 8601 तारीखें और from/body इस्तेमाल होते हैं। त्रुटियों में मशीन-पठनीय कोड होता है (out_of_stock, insufficient_funds, invalid_duration)। number_type छोड़ने पर /inventory हर नंबर प्रकार की जानकारी देता है। पुराने फ़ील्ड नाम अप्रचलित उपनामों के रूप में अब भी काम करते हैं।

  • Newप्राइवेट ईमेल एंडपॉइंट

    किसी नंबर के लिए मुफ़्त [email protected] इनबॉक्स लें, API से मेल पढ़ें और अटैचमेंट डाउनलोड करें।

  • NewMCP सर्वर

    AI एजेंट MCP कुंजी का उपयोग करके टूल के रूप में कीमतें देख सकते हैं, नंबर खरीद सकते हैं और SMS पढ़ सकते हैं।

  • Launchसार्वजनिक REST API v1

    अकाउंट, कीमतें, इन्वेंटरी, नंबर का पूरा जीवनचक्र और SMS, Bearer-टोकन ऑथेंटिकेशन के साथ।

सपोर्ट

अटक गए, या इन दस्तावेज़ों में कुछ ऐसा मिला जो API के असली व्यवहार से मेल नहीं खाता? हमसे संपर्क करें - एंडपॉइंट, अनुरोध का समय और जवाब की बॉडी शामिल करें (अपनी API कुंजी कभी नहीं)।

बनाना शुरू करने के लिए तैयार हैं?

एक कुंजी बनाएँ और एक मिनट से कम समय में अपनी पहली कॉल करें।

शुरू करने के लिए साइन इन करें