डेवलपर API

सार्वजनिक API एक ही एंडपॉइंट और सिर्फ़ GET अनुरोध है: मेथड का नाम action पैरामीटर में जाता है। फ़ॉर्मेट लोकप्रिय प्लेटफ़ॉर्मों जैसा है, इसलिए मौजूदा कोड सिर्फ़ बेस URL बदलने पर चलने लगता है।

एक्सेस कीकी लें
की आपके अकाउंट में बनती है — इसे पाने के लिए लॉग इन या साइन अप करें।की की स्ट्रिंग सिर्फ़ एक बार दिखती है — बनाते समय। खो जाए तो नई बनाएँ और पुरानी रद्द करें।
बेस URL
GEThttps://sim-aggregator.org/stubs/handler_api.php
सभी मेथड इसी पते पर बुलाए जाते हैं; सिर्फ़ action पैरामीटर बदलता है।
काम का क्रम
1getPrices · getServicesListज़रूरी सेवा और देश की कीमत तथा उपलब्धता देखें।
2getNumber · getNumberV2नंबर ऑर्डर करें — जवाब में एक्टिवेशन id और नंबर आता है।
3getStatusकोड आने तक स्टेटस पूछते रहें।
4setStatus · 6सेवा द्वारा कोड स्वीकार होते ही एक्टिवेशन पूरी करें।
—setStatus · 3 · 8एक और कोड चाहिए — 3; नंबर काम न आया — 8, पैसा लौट आएगा।
मेथड सारांश
मेथडकीपैरामीटर
getPricesकी चाहिएaction, api_key, [country], [service]
getCountriesकी चाहिएaction, api_key
getServicesListकी चाहिएaction, api_key, [country]
getBalanceकी चाहिएaction, api_key
getNumberकी चाहिएaction, api_key, country, service, [duration], [maxPrice], [softId]
getNumberV2की चाहिएaction, api_key, country, service, [duration], [maxPrice], [softId]
getStatusकी चाहिएaction, api_key, id
getCurrentActivationsListकी चाहिएaction, api_key
setStatusकी चाहिएaction, api_key, id, status

getPrices

की चाहिए

देश और सेवा के अनुसार कीमत और स्टॉक — कितने नंबर हैं और किस दाम पर।

पैरामीटर
पैरामीटरप्रकारअनिवार्यविवरण
actionstringअनिवार्यमेथड का नाम: getPrices
api_keystringअनिवार्यपैनल से मिली एक्सेस की
countrystringनहींदेश का पहचानकर्ता, जैसे 43
servicestringनहींसेवा का कोड, जैसे wa
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getPrices&api_key=YOUR_API_KEY&country=43
जवाब
{
  "43": {
    "wa": { "cost": 0.5, "count": 100 },
    "tg": { "cost": 0.71, "count": 250 }
  }
}
बिना पैरामीटर यह मेथड पूरा प्राइस फ़ीड देता है — जवाब बहुत बड़ा होता है, इसलिए ज़रूरी देश और सेवा माँगें।
क्या जवाब आ सकते हैं
BAD_COUNTRYदेश नहीं मिला
BAD_SERVICEसेवा नहीं मिली
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है

getCountries

की चाहिए

देशों की सूची: पहचानकर्ता, नाम और देश में कौन-से मोड उपलब्ध हैं।

पैरामीटर
पैरामीटरप्रकारअनिवार्यविवरण
actionstringअनिवार्यमेथड का नाम: getCountries
api_keystringअनिवार्यपैनल से मिली एक्सेस की
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getCountries&api_key=YOUR_API_KEY
जवाब
{
  "43": { "id": 43, "rus": "DE", "eng": "DE", "chn": "DE",
         "visible": 1, "retry": 1, "rent": 0, "multiService": 0 }
}
rus, eng और chn फ़ील्ड में अभी देश का नाम नहीं, बल्कि दो अक्षरों का ISO कोड आता है।
क्या जवाब आ सकते हैं
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है

getServicesList

की चाहिए

सेवाओं की सूची: सेवा का कोड और उसका नाम।

पैरामीटर
पैरामीटरप्रकारअनिवार्यविवरण
actionstringअनिवार्यमेथड का नाम: getServicesList
api_keystringअनिवार्यपैनल से मिली एक्सेस की
countrystringनहींदेश का पहचानकर्ता, जैसे 43
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getServicesList&api_key=YOUR_API_KEY
जवाब
{
  "status": "success",
  "services": [
    { "code": "tg", "name": "Telegram" },
    { "code": "wa", "name": "WhatsApp" }
  ]
}
country पैरामीटर के साथ सूची सिर्फ़ उन सेवाओं तक सिमट जाती है जो वहाँ सच में बिकती हैं।
क्या जवाब आ सकते हैं
BAD_COUNTRYदेश नहीं मिला
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है

getBalance

की चाहिए

खाते का बैलेंस।

पैरामीटर
पैरामीटरप्रकारअनिवार्यविवरण
actionstringअनिवार्यमेथड का नाम: getBalance
api_keystringअनिवार्यपैनल से मिली एक्सेस की
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getBalance&api_key=YOUR_API_KEY
जवाब
ACCESS_BALANCE:12.50
जवाब JSON नहीं, स्ट्रिंग है: राशि कोलन के बाद आती है।
क्या जवाब आ सकते हैं
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है

getNumber

की चाहिए

नंबर ऑर्डर करें। जवाब में एक्टिवेशन id और नंबर आता है।

पैरामीटर
पैरामीटरप्रकारअनिवार्यविवरण
actionstringअनिवार्यमेथड का नाम: getNumber
api_keystringअनिवार्यपैनल से मिली एक्सेस की
countrystringअनिवार्यदेश का पहचानकर्ता, जैसे 43
servicestringअनिवार्यसेवा का कोड, जैसे wa
durationstringनहींऑर्डर की अवधि: activation — एक बार का एक्टिवेशन (डिफ़ॉल्ट); d1, d3, d7 — नंबर 1, 3 या 7 दिन के लिए किराए पर
maxPricestringनहींप्रति नंबर अधिकतम कीमत। इससे महँगा नहीं खरीदेंगे: ऑर्डर की जगह WRONG_MAX_PRICE या NO_NUMBERS आएगा
softIdstringनहींसॉफ़्टवेयर पहचानकर्ता, 255 अक्षरों तक
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getNumber&api_key=YOUR_API_KEY&country=43&service=wa
जवाब
ACCESS_NUMBER:12345:380991234567
जवाब स्ट्रिंग ACCESS_NUMBER:id:नंबर है। id getStatus और setStatus के लिए चाहिए। duration के बिना एक बार का एक्टिवेशन ऑर्डर होता है। duration=d1, d3 या d7 के साथ नंबर किराए पर लिया जाता है और किराया ख़त्म होने तक getCurrentActivationsList में दिखता है। अगर सेवा के पास ऐसी अवधि नहीं है, तो जवाब BAD_SERVICE है। अगर maxPrice दिया गया है और किराया इस सीमा से महँगा है, तो जवाब NO_NUMBERS है, न्यूनतम कीमत के बिना: WRONG_MAX_PRICE:कीमत सिर्फ़ activation के लिए आता है।
क्या जवाब आ सकते हैं
NO_BALANCEऑर्डर के लिए बैलेंस पर्याप्त नहीं
NO_NUMBERSइस जोड़ी के लिए अभी कोई खाली नंबर नहीं
BAD_COUNTRYदेश नहीं मिला
BAD_SERVICEसेवा नहीं मिली
BAD_DURATIONduration का मान अज्ञात है
WRONG_MAX_PRICE:PRICEकीमत maxPrice से ज़्यादा है; कोलन के बाद इस जोड़ी की सबसे कम कीमत है (सिर्फ़ एक बार के एक्टिवेशन के लिए)
BAD_MAX_PRICEmaxPrice संख्या नहीं है या शून्य से बड़ा नहीं है
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
CHANNEL_LIMITएक साथ चलने वाली एक्टिवेशन की सीमा पूरी हो गई
BAD_SOFTWARE_IDsoftId ग़लत है
ERROR_APIसेवा की ओर से अप्रत्याशित त्रुटि

getNumberV2

की चाहिए

नंबर ऑर्डर करें — getNumber जैसा ही, लेकिन सफल जवाब JSON में आता है: कीमत, देश और एक्टिवेशन के समय के साथ।

पैरामीटर
पैरामीटरप्रकारअनिवार्यविवरण
actionstringअनिवार्यमेथड का नाम: getNumberV2
api_keystringअनिवार्यपैनल से मिली एक्सेस की
countrystringअनिवार्यदेश का पहचानकर्ता, जैसे 43
servicestringअनिवार्यसेवा का कोड, जैसे wa
durationstringनहींऑर्डर की अवधि: activation — एक बार का एक्टिवेशन (डिफ़ॉल्ट); d1, d3, d7 — नंबर 1, 3 या 7 दिन के लिए किराए पर
maxPricestringनहींप्रति नंबर अधिकतम कीमत। इससे महँगा नहीं खरीदेंगे: ऑर्डर की जगह WRONG_MAX_PRICE या NO_NUMBERS आएगा
softIdstringनहींसॉफ़्टवेयर पहचानकर्ता, 255 अक्षरों तक
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getNumberV2&api_key=YOUR_API_KEY&country=43&service=wa
जवाब
{
  "activationId": 12345,
  "phoneNumber": "380991234567",
  "activationCost": 0.50,
  "currency": 840,
  "countryCode": "43",
  "canGetAnotherSms": "1",
  "activationTime": "2026-07-31 12:00:00",
  "activationOperator": "any"
}
getNumber से फ़र्क सिर्फ़ सफल जवाब में है। activationTime UTC में है। इनकार getNumber की तरह ही आते हैं — सादी टेक्स्ट स्ट्रिंग में, JSON में नहीं।
क्या जवाब आ सकते हैं
NO_BALANCEऑर्डर के लिए बैलेंस पर्याप्त नहीं
NO_NUMBERSइस जोड़ी के लिए अभी कोई खाली नंबर नहीं
BAD_COUNTRYदेश नहीं मिला
BAD_SERVICEसेवा नहीं मिली
BAD_DURATIONduration का मान अज्ञात है
WRONG_MAX_PRICE:PRICEकीमत maxPrice से ज़्यादा है; कोलन के बाद इस जोड़ी की सबसे कम कीमत है (सिर्फ़ एक बार के एक्टिवेशन के लिए)
BAD_MAX_PRICEmaxPrice संख्या नहीं है या शून्य से बड़ा नहीं है
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
CHANNEL_LIMITएक साथ चलने वाली एक्टिवेशन की सीमा पूरी हो गई
BAD_SOFTWARE_IDsoftId ग़लत है
ERROR_APIसेवा की ओर से अप्रत्याशित त्रुटि

getStatus

की चाहिए

एक्टिवेशन का स्टेटस: कोड का इंतज़ार है या कोड आ चुका है।

पैरामीटर
पैरामीटरप्रकारअनिवार्यविवरण
actionstringअनिवार्यमेथड का नाम: getStatus
api_keystringअनिवार्यपैनल से मिली एक्सेस की
idstringअनिवार्यgetNumber से मिला एक्टिवेशन id
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getStatus&api_key=YOUR_API_KEY&id=12345
जवाब
STATUS_OK:123456
क्या जवाब आ सकते हैं
STATUS_WAIT_CODEनंबर दे दिया गया, कोड अभी नहीं आया
STATUS_OK:CODEकोड मिल गया, अंत में SMS का कोड है
STATUS_WAIT_RETRY:CODEअगले कोड का इंतज़ार है; अंत में पिछला कोड है
STATUS_CANCELएक्टिवेशन पहले ही बंद है: रद्द या पूरा हो चुका है
NO_ACTIVATIONएक्टिवेशन नहीं मिली या पहले ही बंद है
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है

getCurrentActivationsList

की चाहिए

इस कुंजी के सक्रिय ऑर्डर: वे नंबर जो अभी कोड का इंतज़ार कर रहे हैं या कोड पा चुके हैं।

पैरामीटर
पैरामीटरप्रकारअनिवार्यविवरण
actionstringअनिवार्यमेथड का नाम: getCurrentActivationsList
api_keystringअनिवार्यपैनल से मिली एक्सेस की
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getCurrentActivationsList&api_key=YOUR_API_KEY
जवाब
[
  {
    "numberid": 12345,
    "number": "380991234567",
    "status": 0
  }
]
सपाट JSON ऐरे। status: 0 — कोड का इंतज़ार, 3 — कोड मिल गया; बंद ऑर्डर सूची में नहीं आते। सक्रिय ऑर्डर नहीं हैं — खाली ऐरे []।
क्या जवाब आ सकते हैं
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
ERROR_APIसेवा की ओर से अप्रत्याशित त्रुटि

setStatus

की चाहिए

एक्टिवेशन बदलें: एक और कोड माँगें, पूरी करें या रद्द करें।

पैरामीटर
पैरामीटरप्रकारअनिवार्यविवरण
actionstringअनिवार्यमेथड का नाम: setStatus
api_keystringअनिवार्यपैनल से मिली एक्सेस की
idstringअनिवार्यgetNumber से मिला एक्टिवेशन id
statusstringअनिवार्यएक्टिवेशन की नई स्थिति: 3, 6 या 8
अनुरोध
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=setStatus&api_key=YOUR_API_KEY&id=12345&status=6
जवाब
ACCESS_ACTIVATION
एक्टिवेशन साफ़ तौर पर पूरी करें: बंद ऑर्डर स्लॉट खाली करता है, और रद्द करने पर पैसा लौटता है।
status के मान
3उसी नंबर पर एक और कोड माँगें
6एक्टिवेशन पूरी करें: कोड स्वीकार हुआ
8एक्टिवेशन रद्द करें, पैसा बैलेंस में लौटेगा
क्या जवाब आ सकते हैं
ACCESS_ACTIVATIONएक्टिवेशन पूरी हुई
ACCESS_CANCELएक्टिवेशन रद्द हुई, पैसा लौट आया
ACCESS_RETRY_GETअनुरोध स्वीकार हुआ: इसी नंबर पर अगले कोड का इंतज़ार है
NO_ACTIVATIONएक्टिवेशन नहीं मिली या पहले ही बंद है
EARLY_CANCEL_DENIEDरद्द करने के लिए अभी जल्दी है — बाद में दोबारा कोशिश करें
BAD_STATUSअनुमति नहीं: सक्रियण पहले ही बंद है, या कोड दिया जा चुका है और रद्द नहीं किया जा सकता
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
ERROR_APIसेवा की ओर से अप्रत्याशित त्रुटि
सामान्य त्रुटियाँ
BAD_ACTIONaction में अज्ञात मेथड नाम
BAD_KEYकी स्वीकार नहीं हुई: मौजूद नहीं या रद्द है
NO_BALANCEऑर्डर के लिए बैलेंस पर्याप्त नहीं
NO_NUMBERSइस जोड़ी के लिए अभी कोई खाली नंबर नहीं
BAD_COUNTRYदेश नहीं मिला
BAD_SERVICEसेवा नहीं मिली
CHANNEL_LIMITएक साथ चलने वाली एक्टिवेशन की सीमा पूरी हो गई
REQUEST_LIMITप्रति कुंजी अनुरोध सीमा पार हो गई — प्रतीक्षा करें और दोबारा प्रयास करें
BAD_SOFTWARE_IDsoftId ग़लत है
BAD_STATUSstatus का मान समर्थित नहीं
ERROR_APIसेवा की ओर से अप्रत्याशित त्रुटि
सेवा कोडपूरी सूची — getServicesList
waWhatsApp
tgTelegram
vkVK
goGoogle
fbFacebook
lfTikTok
igInstagram
dsDiscord
drOpenAI
aczClaude
देश कोडपूरी सूची — getCountries
43जर्मनी
15पोलैंड
16यूनाइटेड किंगडम
78फ़्रांस
86इटली
56स्पेन
2कज़ाखस्तान
62तुर्किये
187संयुक्त राज्य
22भारत
सीमाएँ
प्रति कुंजी अनुरोध600 प्रति मिनट (≈10 प्रति सेकंड)
स्टेटस पूछनाहर सक्रियण पर 2–5 सेकंड में एक बार