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
aayJioMart
abaRappi
abbCoca-Cola
abcTaptap Send
abdBeBoo
abeFoodora
abgPagBank
abhUOL Host
abkGMX
abnBybit
aboWEBDE
abqUpwork
abtArenaPlus
abuBPJSTK
acDoorDash
acbSpark Driver
acc LuckyLand Slots
aceTata Neu
aciColombian Cupid
acmRazer
acuCityMall
acwYouDo
aczClaude
adaTRUTH SOCIAL
adiZepto
adpCabify
adtwillhaben
aduSeznam
aemyGLO
aegFlowwow
aelCloud Manager
aemAstraPay
aerPlayerAuctions
aetGreywoods
aeuTheFork
aexNeon
aeyNext
aezShein
afeGovBr
affC6 Bank
afkChevron
afmmyboost
afpVFS GLOBAL
afrUltragaz
afsPrivalia
afzKlarna
agbSmiles
agdGrailed
aggOneForma
aghGetnet
agjMarktplaats
agkIpsos iSay
aglBetano
agmCMB
agxMeiQFashion
ahEscapeFromTarkov
ahbUbisoft
aheBunq
ahiDaki
ahjStrato
ahlMaxim
ahrThis Fate
ahvCurve
ahxBitrue
aikZUS Coffee
ailСмотрёшка
aimFirebase
aiqPrime Opinion
aitFeetFinder
aiwRoblox
aixMove It
aizBrevo
ajjRebtel
ajnGopuff
ajyAll Access
akaLinkAja
akd Feels
aklDOKU
akoRyde
akpHer
akrVoi
albGuiche Web
algAnkama
aljSpotify
almMuzz
aloProfee
alsGreggs
amAmazon
amaWooPlus
ambVercel
amwTise
amzImmoScout24
anaSicredi
anbAbastece-aí
angTOMORO COFFEE
anhCadbury
aniTalabat
anlAttaPoll
anmCaltexGO
annBradesco
anoShopify
anqHitnspin
anxInfinitePay
aoeSendwave
aohЮMoney
aoiCryptonow
aokNETELLER
aolPaysera
aomMonzo
aonBinance
aooPegasus Airlines
aopKleinanzeigen
aorOKX
aoyPLN Mobile
aozReclameAQUI
apd2dehands
apfCarrefour
apgDamai
apiKKTIX
aplSideline
apoNetmarble
appClassPass
apqWePoker
aprCapital One
aqGlovo
aqtSkrill
arfEnjoei
arkSageMaker Studio Lab
arpContinente
arsBingo Plus
asbYUEWEN 阅文集团
asfTextFree
aspPhonePe
asqWarpcast
atlWatsons MY
atnFawry
atpVonage
aua同程旅行 Tongcheng Travel
aubSmitten
aucTotalPass
auhKeeTa 美团
aulAlignable
aupBotim
auxLightning AI
auzOutlier
avbTealive
avjSumUp
avvshopFarEast
awgNatura Avon
awqAtlas Earth
awrKCEX
aws7-Eleven
awuMosGram
awvWallapop
awzPlayTime
axnFastMoss
axrMatch
axsAIS PLAY
axtGNJOY
axxShopback
aybAsianDating
ayo360Kredi
ayvmyTVSUPER
ayzKimi
aziTheL
babOpera Mini
baiSNKRDUNK
bajBipa
banBLINK by BonusLink
baqRedbubble
basStoiximan
bavLeoList
bayGenome
bbdDBS Bank
bbfNeosurf
bbgSquare
bbiaiqfome
bbkFilipinoCupid
bblAutodesk
bbmTrueMoney
bbqChime
bcGCash
bckOnion Academy 洋葱学园
bcqMantan/Kopi Kenangan
bcxBantusaku
bdX5ID
bdoAdaModal
bdpKredito
bdrYara Farmcare
bdtHOT51
berGumtree
bexWhatnot
bfaWebmotors
bfgEMAG
bfoMSport
bfrDott
bfvChocofamily
bfwFinya
bgjMoonPay
bgnVeeka
bgtAlfamidi
bgvClearpay
bhbWuling
bhfInPost
bhrDil Mil
bibmyBCA
bicMarktde
bihIndosaku
bijProdege
bixHotel101
bjiPerfect World 完美世界
bjpRia
bjzJeevansathi
bkdSahibinden
bkkPoparide
bkvZen
bkzRewardy
blBIGO LIVE
blaFDJ ParionsSport
bleNexon
bliScalapay
bloSiliconFlow 硅基流动
blpMEEFF
blqAri10
blrDocuSign
blsWeTV
bltINDOPAKET
blx2ememain
blzMiniPay
bmdVooV Meeting
bmemyIM3
bmjBetflag
bmmHey Cash
bmxCanal RCN
bnAlfagift
bngJush
bnlReddit
bnuQpon
bnySuno
boWise
bodGenspark
bogFrance Mobilities
bohYophone
bou汇旺 Huione Pay
bowAffirm
bpGoFundMe
bpcLOVOO
bppBliq
bpqMChat
bptSerpApi
bpzJust Eat
bqbWeex
bqeLottomatica
bqhPEDIR GAS
bqnUpward
bqo Caffe Nero
bqpZara
bqrASAAS
braTouch n Go TNG
breЛемана ПРО
brgLetgo
brrLemFi
brumyPOS
bryMobile DE
bsawill
bsfRupiah Cepat
bsoPayWell
bstAdmiralBet
bsuDingtone
bsvAmarthaFin
bsyAir Miles
bteCROCOBET
btlD4
btnItau
btrDuet
btvRadiate
btxAmap 高德地图
budWeTalk
bvhParenTeam
bviSalams
bwSignal
bwaHostinger
bwdFetch
bweImmutable Play
bwlGuthabende
bwuSkyBet
bwvManus
bwxChagee
bxfDisney Plus
bxgBAT
bxiGrupo Madero
bxjQuero-Quero PAG
bxnIntel SAP
bxpTennents
bxrAlFursan
bxyMAX
bydAirtasker
byfSeaBank
byhAdobe
bypKaito
bywAnnoncelight
bzBlizzard
bzfDabble
bzkAmaze Super App
bzoSeLoger
cajGoMoney
camEleme 饿了么
cauEro Me
cbkFastwork
cctFactory
ccuGoogle Chat
ccvTriumph
ccxGoogle Messenger
cjDotz
cmProm
cnFiverr
coRediffmail
cpUklon
cqMercado
cwPaddyPower
dfHappn
dgMercari
dheBay
dlLazada
doLeboncoin
dpProtonMail
drOpenAI
dsDiscord
eeTwilio
efNextdoor
emZéDelivery
epTemu
etClubhouse
evPicpay
ewNike
exLinode
fbfacebook
fdMamba, MeetMe
fhLalamove
fkBLIBLI
frDana
fsŞikayet var
fuSnapchat
fullПолная аренда
fvVidio
fw99acres
fzKFC
gePaytm
gfGoogleVoice
gjCarousell
gmMocospace
goGoogle,youtube,Gmail
gpTicketmaster
gqFreelancer
grAstropay
gsSamsungShop
gtGett
gxHepsiburadacom
haMy11Circle
hbTwitch
hcMOMO
hpMeesho
htBitso
hwAlipay/Alibaba/1688
hxAliExpress
iebet365
igInstagram+Threads
ijRevolut
imImo
ipBurger King
irChispa
jaWeverse
jgGrab
jiMonobank
jqPaysafecard
juIndomaret
jxSwiggy
kaShopee
kcVinted
kfWeibo
ki99app
kkIdealista
klkolesa.kz
kmRozetka
kqFotoCasa
ktKakaoTalk
lcSubito
lfTikTok/Douyin
liBaidu
ljSantander
lsCareem
maMail.ru
mbYahoo
meLine messenger
mmMicrosoft
moBumble
msNovaPoshta
mtSteam
mvFruitz
mwTransfergo
mxSoulApp
myCAIXA
ncPayoneer
nfNetflix
nhAlloBank
niGojek
nqTrip
nsOldubil
nvNaver
nzFoodpanda
oeCodashop
oiTinder
okОдноклассники
otЛюбой другой
ozPoshmark
pbSkyTV
pcCasino/bet/gambling
pdIFood
pfpof.com
pmAOL
prTrendyol
puJustdating
pzLidl
qfRedBook
qhOriflame
qjWhoosh
qoMoneylion
qqTencent QQ
qvBadoo
qxWorldRemit
qyZhihu
reCoinbase
rkFotka
rlinDriver
rrWolt
saAGIBANK
sgOZON
siCita Previa
snOLX
srStarbucks
teeFood
tgTelegram
tmAkulaku
tnLinkedIN
trPaysend
tsPayPal
tuLyft
twTwitter/X
txBolt
uaBlaBlaCar
ubUber
ueOnet
ufEneba
ukAirbnb
ulGetir
uuWildberries
vdBetfair
vgShellBox
viViber
vkВконтакте
vmOkCupid
vrMotorkuX
vzHinge
waWhatsapp
wbWeChat
wcCraigslist
wgSkout
whTanTan
wrWalmart
wsFeeld
wwBIP
wxApple
xdTokopedia
xhOVO
xkDiDi
xrTango
xsGroupMe
xxJoyride
yaЯндекс
ylYalla
yuXiaomi
ywGrindr
yxJTExpress
yyVenmo
zaJDcom
zbFreeNow
zdZilch
zhZoho
zkDeliveroo
zlAirtel
znBiedronka
zpPinduoduo
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 — внутренняя ошибка, повторите запрос