luxsms API

Публичный API для покупки SMS-активаций программно. Совместим с протоколом SMS-Activate / GreedySMS — если у вас уже есть бот или скрипт, работающий с одним из этих сервисов, для миграции достаточно поменять BASE_URL и api_key.

Как получить ключ

Ключи выдаются вручную по запросу. Напишите администратору в Telegram, укажите ваш telegram_id (тот, под которым вы зарегистрированы в боте) и краткое описание проекта.

После выдачи ключ показывается ОДИН раз — сохраните его сразу. Если потеряли — ключ перевыпускается, старый отзывается.

Запросы тарифицируются с обычного баланса вашего аккаунта (того же, что в боте и на сайте). Пополняйте через личный кабинет.

Базовый URL
https://www.luxsms.top/stubs/handler_api.php

Все эндпоинты — один URL. Действие выбирается параметром action. Поддерживается GET и POST (form-urlencoded или JSON). Ответы — plain text, если явно не написано иначе.

getBalance

Текущий баланс аккаунта в рублях.

GET https://www.luxsms.top/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance

ACCESS_BALANCE:123.45
getPrices

Цены и доступное количество номеров. Возвращает JSON.

  • serviceкод сервиса (tg, wa, ig, …). Опционально
  • countryID страны (0 — Россия и т.д.). Опционально
GET https://www.luxsms.top/stubs/handler_api.php?api_key=KEY&action=getPrices&country=0&service=tg

{"0":{"tg":{"cost":18.40,"count":124}}}
getNumbersStatus

Сколько номеров доступно по сервисам (для совместимости). Возвращает JSON.

  • countryID страны. Опционально
GET https://www.luxsms.top/stubs/handler_api.php?api_key=KEY&action=getNumbersStatus&country=0

{"tg_0":124,"wa_0":89,"ig_0":42}
getNumber

Купить номер. Списывает с баланса, возвращает ID активации и телефон.

  • service*код сервиса
  • country*ID страны
GET https://www.luxsms.top/stubs/handler_api.php?api_key=KEY&action=getNumber&service=tg&country=0

ACCESS_NUMBER:1234567:79991234567

Возможные ошибки:

  • NO_BALANCE — недостаточно средств
  • NO_NUMBERS — номеров по этому сервису/стране нет
  • BAD_KEY — ключ неверный или отозван
getStatus

Узнать статус активации — пришёл ли SMS-код.

  • id*ID активации из getNumber
GET https://www.luxsms.top/stubs/handler_api.php?api_key=KEY&action=getStatus&id=1234567

# ждём код
STATUS_WAIT_CODE

# код пришёл
STATUS_OK:12345

# отменена
STATUS_CANCEL
setStatus

Поменять статус активации.

  • id*ID активации
  • status*1 — ждать ещё SMS, 3 — запросить новый код, 6 — завершить (успех), 8 — отменить (возврат на баланс если не было кода)
GET https://www.luxsms.top/stubs/handler_api.php?api_key=KEY&action=setStatus&id=1234567&status=6

ACCESS_ACTIVATION
Коды сервисов

В параметре service у getNumber / getPrices передаётся короткий код. Полный список можно получить программно:

GET https://www.luxsms.top/stubs/handler_api.php?api_key=KEY&action=getServicesList

[{"code":"tg","name":"Telegram"},{"code":"wa","name":"WhatsApp"}, ...]
КодСервис
aaaNubank
aabBharatPe
aagPockit
aaqNetease
aavAlchemy
aaxBoyaa
abaRappi
abbCoca-Cola
abcTaptap Send
abdBeBoo
abeFoodora
abgPagBank
abkGMX
abnBybit
aboWEBDE
abqUpwork
abtArenaPlus
abuBPJSTK
acDoorDash
acbSpark Driver
acc LuckyLand Slots
acdCloud.ru
aciColombian Cupid
acmRazer
acnGringo
aczClaude
adaTRUTH SOCIAL
adiZepto
adpCabify
adtwillhaben
aelCloud Manager
aemAstraPay
aerPlayerAuctions
aetGreywoods
aexNeon
aeyNext
aezShein
afeGovBr
affC6 Bank
afmmyboost
afpVFS GLOBAL
afrUltragaz
afsPrivalia
afzKlarna
agbSmiles
agdGrailed
aggOneForma
aghGetnet
agiNjuškalo
agjMarktplaats
agkIpsos iSay
aglBetano
agmCMB
agvDoneDeal
ahEscapeFromTarkov
ahbUbisoft
ahdMidnite
aheBunq
ahfGAIL`s Bakery
ahiDaki
ahjStrato
ahlMaxim
aigFive Surveys
aikZUS Coffee
aimFirebase
aiqPrime Opinion
aisDiDiFood
aitFeetFinder
aivRemitly
aiwRoblox
aixMove It
aizBrevo
ajeCupidMedia
ajjRebtel
ajnGopuff
ajqMyValue
ajyAll Access
akaLinkAja
akd Feels
akjEasycash
akoRyde
akpHer
akrVoi
algAnkama
aljSpotify
almMuzz
alsGreggs
amAmazon
amaWooPlus
ambVercel
anaSicredi
anbAbastece-aí
angTOMORO COFFEE
anhCadbury
aniTalabat
anjGemini
anlAttaPoll
anmCaltexGO
annBradesco
anoShopify
anqHitnspin
anxInfinitePay
aoeSendwave
aofGuzman y Gomez
aohЮMoney
aoiCryptonow
aokNETELLER
aomMonzo
aonBinance
aooPegasus Airlines
aopKleinanzeigen
aorOKX
aowGeekay
aoxAukro
aoyPLN Mobile
aozReclameAQUI
apbeToro
apd2dehands
apfCarrefour
apgDamai
apiKKTIX
aplSideline
apoNetmarble
appClassPass
apqWePoker
aprCapital One
aqGlovo
aqtSkrill
aqySAPO
arcCHECK24
areSeated
arfEnjoei
arkSageMaker Studio Lab
arpContinente
arsBingo Plus
aruUNNI 강남언니
asbYUEWEN 阅文集团
asfTextFree
aspPhonePe
asqWarpcast
asyFore Coffee
atlWatsons MY
atrRIDE
atuСбер/Купер
aua同程旅行 Tongcheng Travel
aucTotalPass
auhKeeTa 美团
aujHigh 5 Casino
aulAlignable
aupBotim
auxLightning AI
auzOutlier
avbTealive
avjSumUp
avvshopFarEast
awqAtlas Earth
awrKCEX
aws7-Eleven
awuMosGram
awvWallapop
awzPlayTime
axjFIFGROUP MOBILE CUSTOMER
axmNão Me Perturbe
axnFastMoss
axpChargePoint
axrMatch
axsAIS PLAY
axtGNJOY
axxShopback
aybAsianDating
ayo360Kredi
ayvmyTVSUPER
ayzKimi
aziTheL
azlMotoRan
azyCasa Pariurilor
azzCrystalbet
babOpera Mini
baiSNKRDUNK
banBLINK by BonusLink
baqRedbubble
bavLeoList
bayGenome
bbdDBS Bank
bbgSquare
bbjOnePay
bbkFilipinoCupid
bblAutodesk
bbmTrueMoney
bbqChime
bbrWalletHub
bbuInternationalCupid
bcGCash
bcqMantan/Kopi Kenangan
bcxBantusaku
bdX5ID
bddBetMen
bdgHUD
bdhSingledk
bdoAdaModal
bdpKredito
bdrYara Farmcare
berGumtree
bexWhatnot
bfaWebmotors
bfgEMAG
bfoMSport
bfrDott
bfwFinya
bgjMoonPay
bgtAlfamidi
bgvClearpay
bhfInPost
bhrDil Mil
bibmyBCA
bicMarktde
bihIndosaku
bijProdege
bixHotel101
bjiPerfect World 完美世界
bjzJeevansathi
bkdSahibinden
bkkPoparide
bknbetlive
bkoVision Plus
bkvZen
bkzRewardy
blBIGO LIVE
blaFDJ ParionsSport
bleNexon
blhWinner
bliScalapay
blmEpic Games
bloSiliconFlow 硅基流动
blpMEEFF
blqAri10
blrDocuSign
bltINDOPAKET
blx2ememain
blzMiniPay
bmdVooV Meeting
bmemyIM3
bmiSisal
bnAlfagift
bngJush
bniPets4Homes
bnlReddit
bnsPAC Cash
bntTreasury
bnuQpon
bnySuno
boWise
bobShell GO
bodGenspark
bohYophone
bolMy TELUS
booCasino Plus
bosCasino Portugal
bowAffirm
boxThumbtack
bpGoFundMe
bpcLOVOO
bppBliq
bptSerpApi
bpzJust Eat
bqbWeex
bqhPEDIR GAS
bqiDatanyze
bqnUpward
bqo Caffe Nero
bqpZara
bqrASAAS
bqySNAI
braTouch n Go TNG
brgLetgo
brkIndeed
brrLemFi
bryMobile DE
bsfRupiah Cepat
bsmAhlan
bsoPayWell
bsuDingtone
bsvAmarthaFin
bsyAir Miles
btnItau
btrDuet
btvRadiate
btxAmap 高德地图
budWeTalk
bujASVLA
bviSalams
bvuSwaRail
bwSignal
bwaHostinger
bwdFetch
bweImmutable Play
bwuSkyBet
bwvManus
bwxChagee
bxgBAT
bxjQuero-Quero PAG
bxnIntel SAP
bxpTennents
bxrAlFursan
bxsLikeCard
bxvPAPER
bxwCredinex
bxyMAX
bydAirtasker
byfSeaBank
byhAdobe
bypKaito
bywAnnoncelight
bzBlizzard
bzfDabble
bzkAmaze Super App
cajGoMoney
cakBazaraki
camEleme 饿了么
canBAGI
cauEro Me
cbBazos
cbkFastwork
cctFactory
ccuGoogle Chat
ccvTriumph
ccw夸克 Quark
ccxGoogle Messenger
cjDotz
cmProm
cnFiverr
coRediffmail
cpUklon
cqMercado
cwPaddyPower
dfHappn
dgMercari
dheBay
dlLazada
doLeboncoin
dpProtonMail
drOpenAI
dsDiscord
dyZomato
eeTwilio
efNextdoor
ejMrQ
emZéDelivery
epTemu
etClubhouse
evPicpay
ewNike
exLinode
fbfacebook
fdMamba, MeetMe
fhLalamove
fkBLIBLI
frDana
fsŞikayet var
ftБукмекерские
fuSnapchat
fullПолная аренда
fvVidio
fzKFC
gePaytm
gfGoogleVoice
gjCarousell
gmMocospace
goGoogle,youtube,Gmail
gpTicketmaster
gqFreelancer
gsSamsungShop
gtGett
gxHepsiburadacom
hbTwitch
hcMOMO
htBitso
huUkrnet
hwAlipay/Alibaba/1688
hxAliExpress
iebet365
igInstagram+Threads
ijRevolut
imImo
ipBurger King
irChispa
jgGrab
jqPaysafecard
juIndomaret
jxSwiggy
kaShopee
kcVinted
kfWeibo
ki99app
kkIdealista
klkolesa.kz
kmRozetka
ktKakaoTalk
lcSubito
lfTikTok/Douyin
liBaidu
ljSantander
lsCareem
lyOlacabs
maMail.ru
mbYahoo
meLine messenger
mmMicrosoft
moBumble
msNovaPoshta
mtSteam
mwTransfergo
mxSoulApp
myCAIXA
ncPayoneer
nfNetflix
nhAlloBank
niGojek
nqTrip
nvNaver
nzFoodpanda
oiT1nder
okОдноклассники
otЛюбой другой
ozPoshmark
pcCasino/bet/gambling
pdIFood
pfpof.com
pmAOL
prTrendyol
pzLidl
qfRedBook
qjWhoosh
qqTencent QQ
qvBadoo
qxWorldRemit
reCoinbase
rlinDriver
rrWolt
rsLotus
rthily
ryMcDonalds
saAGIBANK
sgOZON
siCita Previa
snOLX
teeFood
tgTelegram
tlTruecaller
tmAkulaku
tnLinkedIN
trPaysend
tsPayPal
tuLyft
twTwitter/X
txBolt
uaBlaBlaCar
ubUber
ueOnet
ufEneba
ukAirbnb
uuWildberries
uzOffGamers
vdBetfair
viViber
vkВконтакте
vmOkCupid
vpKwai
vrMotorkuX
vzHinge
waWhatsapp
wbWeChat
wcCraigslist
wgSkout
whTanTan
wrWalmart
wsFeeld
wwBIP
wxApple
xdTokopedia
xhOVO
xkDiDi
xrTango
xsGroupMe
xuRecargaPay
xxJoyride
yaЯндекс
ylYalla
ynAllegro
ywGrindr
yxJTExpress
yyVenmo
zaJDcom
zdZilch
zhZoho
zkDeliveroo
zmOfferUp
zoKaggle
zsBilibili
zyNttgame
Коды стран

В параметре country передаётся числовой ID. Полный список — через API:

GET https://www.luxsms.top/stubs/handler_api.php?api_key=KEY&action=getCountriesList

[{"id":0,"name_ru":"Россия","name_en":"Russia"}, ...]
IDСтранаCountry
1УкраинаUkraine
2КазахстанKazakhstan
3КитайChina
4ФилиппиныPhilippines
5МьянмаMyanmar
6ИндонезияIndonesia
7МалайзияMalaysia
8КенияKenya
9ТанзанияTanzania
10ВьетнамVietnam
11КыргызстанKyrgyzstan
13ИзраильIsrael
14ГонконгHong Kong
15ПольшаPoland
16ВеликобританияUnited Kingdom
17МадагаскарMadagascar
18Дем. КонгоDR Congo
19НигерияNigeria
20МакаоMacao
21ЕгипетEgypt
22ИндияIndia
23ИрландияIreland
24КамбоджаCambodia
25ЛаосLaos
26ГаитиHaiti
27Кот д'ИвуарIvory Coast
28ГамбияGambia
29СербияSerbia
30ЙеменYemen
31ЮАРSouth Africa
32РумынияRomania
33КолумбияColombia
34ЭстонияEstonia
35АзербайджанAzerbaijan
36КанадаCanada
37МароккоMorocco
38ГанаGhana
39АргентинаArgentina
40УзбекистанUzbekistan
41КамерунCameroon
42ЧадChad
43ГерманияGermany
44ЛитваLithuania
45ХорватияCroatia
46ШвецияSweden
47ИракIraq
48НидерландыNetherlands
49ЛатвияLatvia
50АвстрияAustria
51БеларусьBelarus
52ТаиландThailand
53Сауд. АравияSaudi Arabia
54МексикаMexico
55ТайваньTaiwan
56ИспанияSpain
57ИранIran
58АлжирAlgeria
59СловенияSlovenia
60БангладешBangladesh
61СенегалSenegal
62ТурцияTurkey
63ЧехияCzech
64Шри-ЛанкаSri Lanka
65ПеруPeru
66ПакистанPakistan
67Новая ЗеландияNew Zealand
68ГвинеяGuinea
69МалиMali
70ВенесуэлаVenezuela
71ЭфиопияEthiopia
72МонголияMongolia
73БразилияBrazil
74АфганистанAfghanistan
75УгандаUganda
76АнголаAngola
77КипрCyprus
78ФранцияFrance
79Папуа-Новая ГвинеяPapua
80МозамбикMozambique
81НепалNepal
82БельгияBelgium
83БолгарияBulgaria
84ВенгрияHungary
85МолдоваMoldova
86ИталияItaly
87ПарагвайParaguay
88ГондурасHonduras
89ТунисTunisia
90НикарагуаNicaragua
91Тимор-ЛестеTimor-Leste
92БоливияBolivia
93Коста РикаCosta Rica
94ГватемалаGuatemala
95ОАЭUAE
96ЗимбабвеZimbabwe
97Пуэрто-РикоPuerto Rico
98СуданSudan
99ТогоTogo
100КувейтKuwait
101СальвадорSalvador
Пример: Python
import requests, time

API_KEY = "ls_live_..."
BASE = "https://www.luxsms.top/stubs/handler_api.php"

def call(action, **params):
    r = requests.get(BASE, params={"api_key": API_KEY, "action": action, **params})
    return r.text

# 1. Купить номер
resp = call("getNumber", service="tg", country=0)
# ACCESS_NUMBER:1234567:79991234567
_, activation_id, phone = resp.split(":")

# 2. Ждать код
while True:
    s = call("getStatus", id=activation_id)
    if s.startswith("STATUS_OK:"):
        code = s.split(":")[1]
        break
    time.sleep(5)

# 3. Завершить
call("setStatus", id=activation_id, status=6)
Коды ошибок
  • BAD_KEY — неверный или отозванный ключ
  • BAD_ACTION — неизвестное действие
  • BAD_SERVICE — нет service / country
  • BAD_STATUS — недопустимый статус
  • NO_BALANCE — недостаточно средств
  • NO_NUMBERS — номеров нет
  • NO_ACTIVATION — активация не ваша или не существует
  • ERROR_SQL — внутренняя ошибка, повторите запрос