API documentation
API is a Protocol of interaction between your SOFTWARE and our activation server.
The API is needed in order to automate the process of receiving SMS messages on your side All requests (supported by POST and GET) should go to
https://sms-activation-service.com/stubs/handler_apiC:\Windows\System32\drivers\etc\
185.12.126.62 sms-activate.ru
WARNING! If you spoof the host, there will be an https protocol error. To avoid it, send requests without https using http
185.12.126.62 sms-activate.ru
185.12.126.62 api.sms-activate.org
185.12.126.62 api.sms-man.ru
185.12.126.62 sms-man.ru
185.12.126.62 smshub.org
185.12.126.62 api.smshub.org
Attention
All requests must have API key-parameter "api_key", localization for interaction with ruble / dollar (ru/en) balance-parameter "lang", method name-parameter "action".
API key You can get in the section:Profile.
getBalance
To check the balance
https://sms-activation-service.com/stubs/handler_api?api_key=APIKEY&action=getBalance&lang=LANGField
Type
Description
api_key
string
Your API key provides access to paid services. The API key should be kept secret
action
string
Method name
lang
string
Localization ru or en
Server response:
Example answer:
463.02
getCountryAndOperators
Get all countries and operators available to them
https://sms-activation-service.com/stubs/handler_api?api_key=APIKEY&action=getCountryAndOperators&lang=LANGField
Type
Description
api_key
string
Your API key provides access to paid services. The API key should be kept secret
lang
string
Localization ru or en
Server response:
Sample JSON response:
[{"id":0,"name":"Russia","operators":{"any":"any","tele2":"tele2","tinkoff":"tinkoff","ttk":"ttk","yota":"yota"}},{"id":1,"name":"Ukraine","operators":{"any":"any","kyivstar":"kyivstar","life":"life","lycamobile":"lycamobile","mts":"mts","utel":"utel","vodafone":"vodafone"}}]
Field
Example
Description
id
0
Country ID
name
Russia
Country name
operators
["operators":{"aiva":"aiva", "any":"any"}]
Array with operator IDs
getServicesAndCost
Get current prices and number of rooms
https://sms-activation-service.com/stubs/handler_api?api_key=APIKEY&action=getServicesAndCost&country=COUNTRY&operator=OPERATOR&lang=LANGField
Type
Description
api_key
string
Your API key provides access to paid services. The API key should be kept secret
lang
string
Localization ru or en
Server response:
Sample JSON response:
[{"id":"vk","name":"Вконтакте","price":29.88,"quantity":"19"},{"id":"ok","name":"Ok.ru","price":1.34,"quantity":"2776"},{"id":"wa","name":"Whatsapp","price":0,"quantity":"0"}]
Field
Example
Description
id
vk
Service ID
name
Вконтакте
Service name
price
29.88
Actual price
quantity
19
Number of rooms
getNumber
Room booking
https://sms-activation-service.com/stubs/handler_api?api_key=APIKEY&action=getNumber&service=SERVICE&operator=OPERATOR&country=COUNTRY&lang=LANGField
Type
Description
api_key
string
Your API key provides access to paid services. The API key should be kept secret
action
string
Method name
lang
string
Localization ru or en
Server response:
Server response
Example
Description
NO_BALANCE
NO_BALANCE
Not enough balance on the API account
NO_NUMBERS
NO_NUMBERS
No numbers with the given parameters, try later, or change operator, country.
ACCESS_NUMBER:ID:NUMBER
ACCESS_NUMBER:234242:79991728822
We have received number, activation ID - ID, number itself with country code - NUMBER
setStatus
To change the status
https://sms-activation-service.com/stubs/handler_api?api_key=APIKEY&action=setStatus&id=ID&status=STATUS&lang=LANGField
Type
Description
api_key
string
Your API key provides access to paid services. The API key should be kept secret
action
string
Method name
id
integer
Activation ID received when requesting a number
status
integer
Status to be transferred to activation
lang
string
Localization ru or en
Available statuses:
3 - Request another sms
6 - Complete activation
8 - Cancel order
Server response:
Server response
Description
NO_BALANCE
Not enough balance on the API account
ACCESS_CANCEL
Activation canceled
ACCESS_RETRY_GET
Waiting for new SMS
ACCESS_ACTIVATION
Activation successfully completed
getStatus
To obtain the current status
https://sms-activation-service.com/stubs/handler_api?api_key=APIKEY&action=getStatus&id=ID&lang=LANGField
Type
Description
api_key
string
Your API key provides access to paid services. The API key should be kept secret
action
string
Method name
id
integer
Activation ID received when requesting a number
lang
string
Localization ru or en
Server response:
Server response
Description
STATUS_WAIT_CODE
Waiting for SMS to arrive
STATUS_CANCEL
Activation canceled
STATUS_OK:CODE
Code received (where CODE is the activation code)
getCurrentActivationsList
To obtain the current status
https://sms-activation-service.com/stubs/handler_api?api_key=APIKEY&action=getCurrentActivationsList&status=STATUS&limit=LIMIT&order=ORDER&orderBy=ORDERBY&lang=LANGField
Type
Description
api_key
string
Your API key provides access to paid services. The API key should be kept secret
action
string
Method name
status
integer
Status number to filter (available - 0 (new, waiting for sms) | 1 (completed) | 2 (cancelled) | 3 (received sms) | 4 (waiting for additional sms))
order
string
By which field we sort (available - id/number/date)
orderBy
string
Sorting in ascending/descending order (ASC/DESC)
lang
string
Localization ru or en
Server response:
Sample JSON response:
[ { "numberid": 1539723, "number": "380916172774", "status": 1 }, { "numberid": 1081409, "number": "380916147785", "status": 1 } ]
Annex 1. List of countries
ID
Name
Available operators
0
Russia
aiva, any, beeline, center2m, danycom, ezmobile, lycamobile, matrix, megafon, motiv, mts, mtt, mtt_virtual, rostelecom, sber, simsim, tele2, tinkoff, ttk, winmobile, yota,
1
Ukraine
3mob, any, intertelecom, kyivstar, life, lycamobile, mts, utel, vodafone,
2
Kazakhstan
activ, altel, any, beeline, kcell, tele2,
3
China
any, chinamobile, china_unicom, unicom,
16
England (UK)
any, cmlink, ee, ezmobile, lebara, lycamobile, o2, orange, talk_telecom, three, tmobile, vectone, vodafone,
5
Myanmar
any, telenor,
6
Indonesia
any,
7
Malaysia
any, celcom, digi, hotlink, u_mobile, xox,
8
Kenya
airtel, any, econet, orange, safaricom, telkom,
9
Tanzania
airtel, any, tigo, vodacom,
10
Viet Nam
any, itelecom, mobifone, vietnamobile, viettel, vinaphone,
11
Kyrgyzstan
any, beeline, megacom, o!,
12
USA (Virtual)
any, cellular, tmobile,
13
Israel
019mobile, any, golan_telecom, home_cellular, hot_mobile, jawwal, ooredoo, orange, pelephone, rami_levy,
14
Hong Kong (China)
any, chinamobile, csl_mobile, imc, smartone, three, unicom,
15
Poland
aero2, any, e_telko, klucz, lycamobile, netia, orange, play, plus, tmobile,
4
Philippines
any, globe_telecom, smart, tm,
17
Madagascar
any,
18
Dem. Congo
africel, airtel, any, orange, vodacom,
19
Nigeria
airtel, any, etisalat, glomobile, mtn,
20
Macau
any,
21
Egypt
any, etisalat, orange, vodafone,
22
India
any,
23
Ireland
48mobile, any, lycamobile, tesco,
24
Cambodia
any, metfone,
25
Laos
any, etl, telekom, tplus, unitel,
26
Haiti
any, natcom,
27
Côte d'Ivoire
any, moov, mtn, orange,
28
Gambia
africel, any, comium, gamcel, qcell,
29
Serbia
any, mobtel, mts, vip,
30
Yemen
any, mtn, sabafon, yemen_mobile,
31
SOUTH AFRICA
any, cell_c, lycamobile, mtn, telkom, vodacom,
32
Romania
any, digi, lycamobile, my_avon, orange, runex_telecom, telekom, vodafone,
33
Colombia
any, claro, movistar,
34
Estonia
any, elisa, goodline, super, tele2, topconnect,
35
Azerbaijan
any,
36
Canada
any, cellular, fido, lucky, rogers, telus,
37
Morocco
any, iam, inwi, itissalat, orange,
38
Ghana
airtel, any, glomobile, millicom, mtn, vodafone,
39
Argentina
any,
40
Uzbekistan
any, beeline, humans, mobiuz, mts, ucell, uzmobile,
41
Cameroon
any, mtn, nexttel, orange,
42
Chad
airtel, any, salam, tigo,
43
Germany
any, fonic, lebara, lycamobile, o2, ortel_mobile, telekom, vodafone,
44
Lithuania
any, bite, tele2, telia,
45
Croatia
a1, any, tele2, tmobile, tomato,
46
Sweden
any, comviq, lycamobile, tele2, telenor, telia, three, vectone, vodafone,
47
Iraq
any, asiacell, korek, zain,
48
Netherlands
any, kpn, lebara, lycamobile, l_mobi, tmobile, vodafone,
49
Latvia
any, bite, lmt, tele2,
50
Austria
a1, any, orange, telering, three, tmobile,
51
Belarus
any, life, mdc, mts,
52
Thailand
ais, any, dtac, truemove,
53
Saudi Arabia
any,
54
Mexico
any, telcel,
55
Taiwan
any, chunghwa, fareast,
56
Spain
altecom, any, euskaltel, lebara, llamaya, lycamobile, movistar, orange, vodafone, yoigo, you_mobile,
57
Iran
any, aptel, azartel, hamrah_e_aval, irancell, mtn, rightel, samantel, shatel, taliya, tci,
58
Algeria
any, djezzy, mobilis, ooredoo,
59
Slovenia
any,
60
Bangladesh
any,
61
Senegal
any, expresso, free, orange,
62
Turkey
any, turkcell,
63
Czech Republic
any, o2, tmobile, vodafone,
64
Sri Lanka
airtel, any, etisalat,
65
Peru
any,
66
Pakistan
any,
67
New Zealand
2degree, any, vodafone,
68
Guinea
any, cellcom, mtn, orange, sotelgui, telecel,
69
Mali
any, malitel, orange, telecel,
70
Venezuela
any,
71
Ethiopia
any,
72
Mongolia
any, beeline,
73
Brazil
algartelecom, any, claro, correios_celular, oi, tim, vivo,
74
Afghanistan
any, salaam,
75
Uganda
airtel, any, k2_telecom, lycamobile, mtn, orange, smart, smile, uganda_telecom,
76
Angola
any,
77
Cyprus
any, cablenet, cyta, epic, lemontel, primetel, vectone,
78
France
any, bouygues, lebara, lycamobile, orange, sfr, syma_mobile, vectone,
79
New Guinea
any,
80
Mozambique
any,
81
Nepal
any,
82
Belgium
any,
83
Bulgaria
a1, any, telenor, vivacom,
84
Hungary
any,
85
Moldova
any, idc, moldcell, orange, unite,
86
Italy
any,
87
Paraguay
any,
88
Honduras
any, claro,
89
Tunisia
any, ooredoo, orange, tunicell,
90
Nicaragua
any, movistar,
91
Timor-Leste
any,
92
Bolivia
any,
93
Costa Rica
any,
94
Guatemala
any, claro, movistar, tigo,
95
UNITED ARAB EMIRATES
any,
96
Zimbabwe
any, econet,
97
Puerto Rico
any,
98
Sudan
any, mtn, sudani_one, zain,
99
Togo
any,
100
Kuwait
any,
101
El Salvador
any, claro, digi, movistar, red, tigo,
102
Libya
any,
103
Jamaica
any, digi,
104
Trinidad and Tobago
any,
105
Ecuador
any, claro, cnt_mobile, movistar, tuenti,
106
Swaziland
any,
107
Oman
any,
108
Bosnia and Herzegovina
any,
109
Dominican Republic
altice, any, claro, viva,
111
Qatar
any,
113
Cuba
any,
112
Panama
any,
114
Mauritania
any, chinguitel, mattel, mauritel,
115
Sierra Leone
africel, airtel, any, qcell,
116
Jordan
any, orange, umniah, xpress, zain,
117
Portugal
any, lycamobile, nos, vodafone,
118
Barbados
any,
119
Burundi
any,
120
Benin
any,
121
Brunei
any,
122
Bahamas
any,
123
Botswana
any, be_mobile, mascom, orange,
124
Belize
any,
125
CAR
any,
126
Dominica
any,
127
Grenada
any,
128
Georgia
any, beeline, geocell, hamrah_e_aval, magticom,
129
Greece
any, cosmote, ose, q_telecom, vodafone,
130
Guinea-Bissau
any,
131
Guyana
any,
132
Iceland
any,
133
Comoros
any,
134
Saint Kitts and Nevis
any,
135
Liberia
any, cellcom, comium, libercell, libtelco, lonestar,
136
Lesotho
any,
137
Malawi
any,
138
Namibia
any,
139
Niger
any,
140
Rwanda
any,
141
Slovakia
any,
142
Suriname
any,
143
Tajikistan
any,
144
Monaco
any,
145
Bahrain
any,
146
Reunion
any,
147
Zambia
any,
148
Armenia
any, viva, vivo,
149
Somalia
any,
150
Congo
any,
151
Chile
any, claro, entel, movistar,
152
Burkina Faso
airtel, any, onatel, telecel,
153
Lebanon
alfa, any, ogero, touch,
154
Gabon
any,
155
Albania
any,
156
Uruguay
any,
157
Mauritius
any,
158
Bhutan
any,
159
Maldives
any,
160
Guadeloupe
any,
161
Turkmenistan
any,
162
French Guiana
any,
163
Finland
any, dna,
164
Saint Lucia
any,
165
Luxembourg
any,
166
Saint Pierre and Miquelon
any,
167
Equatorial Guinea
any,
168
Djibouti
any,
169
Saint Kitts and Nevis
any,
170
Cayman Islands
any,
171
Montenegro
any,
172
Denmark
any, lycamobile,
173
Switzerland
any,
174
Norway
any,
175
Australia
any,
176
Eritrea
any,
177
South Sudan
any,
178
Sao Tome and Principe
any,
179
Aruba
any,
180
Montserrat
any,
181
Anguilla
any,
183
Northern Macedonia
any,
184
Republic of Seychelles
any,
185
New Caledonia
any,
186
Cape Verde
any,
187
USA (Real)
any, lycamobile, tmobile,
190
South Korea
any,
189
Fiji
any,
195
Bermuda
any,
Annex 2. Service list
ID
Name
vk
Вконтакте
ok
Ok.ru
wa
WhatsApp (Not available)
vi
Viber
tg
Telegram
wb
go
Google,youtube,Gmail
av
avito
fb
tw
ub
Uber
qw
Киви
gt
Gett
sn
OLX
ig
ss
Hezzl
ym
Юла
ma
Mail.ru
mm
Microsoft
uk
Airbnb
me
Line msg
mb
Yahoo
we
ДругВокруг
bd
X5ID
kp
HQ Trivia
dt
Delivery Club
ya
Яндекс
mt
Steam
oi
Tinder
fd
Mamba
zz
Dent
kt
KakaoTalk
pm
AOL
tn
Tencent QQ
mg
Магнит
pf
pof.com
yl
Yalla
kl
kolesa.kz
po
premium.one
nv
Naver
nf
Netflix
iq
icq
ob
Onlinerby
kb
kufarby
im
Imo
mc
Michat
ds
Discord
vv
Seosprint
ji
Monobank
lf
TikTok/Douyin
hu
Ukrnet
wg
Skout
rz
EasyPay
vf
Q12 Trivia
ny
Pyro Music
rr
Wolt
fe
CliQQ
la
ssoidnet
zh
Zoho
gp
Ticketmaster
am
Amazon
ly
Olacabs
tc
Rambler
dp
ProtonMail
pg
NRJ Music Awards
yf
Citymobil
op
MIRATORG
fx
PGbonus
qr
MEGA
yk
СпортМастер
ls
Careem
bl
BIGO LIVE
mu
MyMusicTaste
fu
Snapchat
bf
Keybase
sg
OZON
uu
Wildberries
ua
BlaBlaCar
ab
Alibaba
iv
Inboxlv
zy
Nttgame
gd
Surveytime
fy
Mylove
ce
mosru
tl
Truecaller
hm
Globus
tx
Bolt
ka
Shopee
pl
Перекресток
ip
Burger King
cm
Prom
hw
AliPay
de
Karusel
jc
IVI
rl
inDriver
df
Happn
ui
RuTube
up
Magnolia
nz
Foodpanda
kf
ri
BillMill
cc
Quipp
lr
Okta
za
JDcom
da
MTS CashBack
ug
Fiqsy
sq
KuCoinPlay
zr
Papara
xv
Wish
cx
Icrypex
cw
PaddyPower
li
Baidu
dz
Dominos Pizza
xz
paycell
rd
Lenta
qb
Payberry
hz
Drom
gl
GlobalTel
zk
Deliveroo
ia
Socios
xl
Wmaraci
yi
Yemeksepeti
ew
Nike
ae
myGLO
gb
YouStar
cy
РСА
qm
RosaKhutor
dh
eBay
yb
Квартплата+
qe
GG
yw
Grindr
uz
OffGamers
gx
Hepsiburadacom
re
Coinbase
tj
dbrUA
ts
PayPal
rt
hily
sf
SneakersnStuff
sv
Dostavista
qi
23red
bz
Blizzard
db
ezbuy
vw
CoinField
zl
Airtel
wf
YandexGo
lw
MrGreen
co
Rediffmail
ey
miloan
ge
Paytm
os
Dhani
ql
CMTcuzdan
cq
Mercado
xk
DiDi
py
Monese
rv
Kotak811
jl
Hopi
pr
Trendyol
pu
Justdating
dk
Pairs
fm
Touchance
ph
SnappFood
sw
NCsoft
nr
Tosla
hy
Ininal
tr
Paysend
pq
CDkeys
ff
AVON
sd
dodopizza
ry
McDonalds
le
E bike Gewinnspiel
hr
JKF
qa
MyFishka
wc
Craigslist
kw
Foody
jg
Grab
mj
Zalo
eu
LiveScore
ll
888casino
ed
Gamer
pp
Huya
th
WestStein
xr
Tango
iz
Global24
tk
МВидео
rx
Sheerid
ki
99app
my
CAIXA
zm
OfferUp
tq
Swvl
au
Haraj
ei
Taksheel
rp
hamrahaval
pa
Gamekit
fs
Şikayet var
ul
Getir
cf
irancell
bt
Alfa
ud
Disney Hotstar
qu
Agroinform
un
humblebundle
rm
Faberlic
uo
CafeBazaar
ti
cryptocom
nk
Gittigidiyor
jm
mzadqatar
lp
Algida
si
Cita Previa
fj
Potato Chat
pt
Bitaqaty
qc
Праймериз 2020
yo
Amasia
ve
Dream11
qh
Oriflame
iu
Bykea
ib
Immowelt
zv
Digikala
jb
Wing Money
vn
Yaay
wn
GameArena
bj
Вита экспресс
st
Ашан
ev
Picpay
qn
Blued
cd
SpotHit
vo
Brand20ua
il
IQOS
dx
Powerkredite
el
Bisu
dn
Paxful
lk
PurePlatfrom
vc
Banqi
wj
1хbet
wk
Mobile01
jj
Aitu
an
Adidas
jr
Самокат
nb
Верный
gv
Humta
dw
Divar
gj
Carousell
hc
MOMO
uf
Eneba
kn
Verse
qd
Taobao
hn
1688
zf
OnTaxi
gi
Hotline
uc
Tatneft
mn
RRSA
ak
Douyu
cp
Uklon
qo
Moneylion
wx
Apple
et
Clubhouse
px
Nifty
jh
PingPong
lb
Mailru Group
md
Банки
lt
BitClout
sk
Skroutz
oh
MapleSEA
km
Rozetka
af
GalaxyWin
tt
Ziglu
jf
Likee
az
CityBase
yn
Allegro
wl
YouGotaGift
dl
Lazada
gc
TradingView
cn
Fiverr
ou
Gabi
vp
Kwai
rj
Детский мир
uh
Yubo
es
iQIYI
be
СберМегаМаркет
aq
Glovo
pd
IFood
zw
Quack
gm
Mocospace
fi
Dundle
hg
Switips
qz
Faceit
gz
LYKA
jq
Paysafecard
ue
Onet
xf
LightChat
bp
GoFundMe
vy
Meta
ea
JamesDelivery
hj
Столото
sh
ВкусВилл
vg
ShellBox
qf
RedBook
nq
Trip
ww
BIP
ke
Эльдорадо
qj
Whoosh
ol
KazanExpress
tm
Akulaku
ra
KeyPay
xj
СберМаркет
vd
Betfair
ni
Gojek
mr
Fastmail
hx
AliExpress
bv
Metro
sj
HandyPick
td
ChaingeFinance
dm
Iwplay
xs
GroupMe
kz
NimoTV
nu
Stripe
kr
Eyecon
pz
Lidl
hb
Twitch
xe
GalaxyChat
io
ЗдравСити
ad
Iti
zg
Setel
ij
Revolut
sl
СберАптека
wp
163СOM
en
Hermes
zo
Kaggle
vx
HeyBox
hl
Band
lq
Potato
uj
СhampionСasino
ga
Roposo
bo
Wise
fz
KFC
vm
OkCupid
ch
Pocket52
yp
Payzapp
cs
AgriDevelop
yg
CourseHero
lj
Santander
oz
Poshmark
wh
TanTan
wt
IZI
og
Okko
xq
MPL
xh
OVO
kc
Vinted
hk
4Fun
yz
Около
eo
Sizeer
ft
Букмекерские
tf
Noon
lv
Megogo
dy
Zomato
lx
DewuPoison
nn
Giftcloud
zs
Bilibili
kx
Vivo
ee
Twilio
tp
IndiaGold
ku
RoyalWin
ca
SuperS
va
SportGully
ej
MrQ
yu
Xiaomi
np
Siply
uy
Meliuz
sb
Lamoda
zd
Zilch
zn
Biedronka
je
Nanovest
gw
CallApp
qk
Bit
xi
InFund
ju
Indomaret
dv
NoBroker
mk
LongHu
iy
FoodHub
ys
ZCity
ax
CrefisaMais
aw
Taikang
ne
Coindcx
fr
Dana
mf
Weidian
he
Mewt
od
FWDMAX
gu
Fora
xd
Tokopedia
gf
GoogleVoice
yy
Venmo
dg
Mercari
oc
DealShare
sm
YoWin
aj
OneAset
ta
Wink
cj
Dotz
vz
Hinge
yv
IPLwin
xy
Depop
bn
Alfagift
ik
GuruBets
rk
Fotka
vj
Stormgain
sz
Pivko24
cr
TenChat
oq
Vlife
of
Urent
gk
AptekaRU
bb
LazyPay
mh
Ашан
hq
Magicbricks
fw
99acres
cu
炙热星河
mi
Zupee
zi
LoveLocal
aa
Probo
rf
Akudo
so
RummyWealth
zq
IndiaPlays
xt
Flipkart
ln
Grofers
us
IRCTC
kg
FreeChargeApp
gh
GyFTR
lh
24betting
wo
Parkplus
rg
Porbet
cz
Getmega
tu
Lyft
ih
TeenPattiStarpro
rh
Ace2Three
xb
RummyOla
fc
PharmEasy
hi
JungleeRummy
fl
RummyLoot
oy
CashFly
jx
Swiggy
rc
Skype
eg
ContactSys
ba
Expressmoney
oe
Codashop
gs
SamsungShop
ml
ApostaGanha
mq
GMNG
jt
TurkiyePetrolleri
sp
HappyFresh
sa
AGIBANK
rb
Tick
mo
Bumble
do
Leboncoin
ac
DoorDash
uv
BinBin
ru
HOP
wq
Leboncoin1
yj
eWallet
jz
Kaya
su
LOCO
ur
MyDailyCash
xu
RecargaPay
no
Virgo
kh
Bukalapak
eh
Profi100
ot
Not in list
Possible error
Server response
Description
BAD_ACTION
Incorrect request generation
BAD_KEY
Incorrect API key
BAD_LANG
Incorrect locale, accepted ru or en
NO_ACTIVATION
Activation ID does not exist
ERROR_SQL
SQL Server database error
ERROR_API
Processing error