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-service-online.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-service-online.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-service-online.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-service-online.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-service-online.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-service-online.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-service-online.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-service-online.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,
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, 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, 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,
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, moldcell, orange, unite,
86
Italy
any,
87
Paraguay
any,
88
Honduras
any,
89
Tunisia
any, ooredoo, orange, tunicell,
90
Nicaragua
any,
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,
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, cnt_mobile, 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, 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
la
ssoidnet
qj
Whoosh
aw
Taikang
ke
Эльдорадо
me
Line msg
da
MTS CashBack
ul
Getir
ud
Disney Hotstar
yw
Grindr
fy
Mylove
ob
Onlinerby
vw
CoinField
nb
Верный
nz
Foodpanda
jq
Paysafecard
yk
СпортМастер
rr
Wolt
xf
LightChat
fd
Mamba
nk
Gittigidiyor
hu
Ukrnet
hl
Band
wb
ne
Coindcx
uk
Airbnb
vk
Вконтакте
vx
HeyBox
nv
Naver
sn
OLX
tq
Swvl
dz
Dominos Pizza
hn
1688
tr
Paysend
Tencent QQ
lv
Megogo
hj
Столото
ed
Gamer
wa
WhatsApp (Not available)
hb
Twitch
cx
Icrypex
cw
PaddyPower
hg
Switips
cm
Prom
mj
Zalo
fj
Potato Chat
gj
Carousell
ia
Socios
md
Банки
nu
Stripe
cj
Dotz
sm
YoWin
zo
Kaggle
an
Adidas
qz
Faceit
mn
RRSA
kc
Vinted
mc
Michat
rl
inDriver
lx
DewuPoison
qd
Taobao
tw
gl
GlobalTel
fr
Dana
fe
CliQQ
jc
IVI
tn
nq
Trip
pg
NRJ Music Awards
ff
AVON
sd
dodopizza
cn
Fiverr
bj
Вита экспресс
bz
Blizzard
rx
Sheerid
aq
Glovo
bl
BIGO LIVE
bt
Alfa
zy
Nttgame
dm
Iwplay
ok
Ok.ru
cy
РСА
rz
EasyPay
st
Ашан
mb
Yahoo
uy
Meliuz
py
Monese
si
Cita Previa
jh
PingPong
tc
Rambler
ak
Douyu
hk
4Fun
rt
hily
qw
Киви
zk
Deliveroo
cq
Mercado
af
GalaxyWin
yo
Amasia
kl
kolesa.kz
hm
Globus
ot
Not in list
fm
Touchance
zd
Zilch
ei
Taksheel
wn
GameArena
ca
SuperS
qi
23red
og
Okko
lr
Okta
lj
Santander
jg
Grab
pp
Huya
xq
MPL
my
CAIXA
kw
Foody
lw
MrGreen
yv
IPLwin
pz
Lidl
wk
Mobile01
qu
Agroinform
sl
СберАптека
pa
Gamekit
up
Magnolia
ui
RuTube
dl
Lazada
qm
RosaKhutor
ou
Gabi
ub
Uber
ri
BillMill
ts
PayPal
av
avito
vf
Q12 Trivia
ma
Mail.ru
xi
InFund
ga
Roposo
mg
Магнит
ae
myGLO
mu
MyMusicTaste
sq
KuCoinPlay
ad
Iti
ev
Picpay
ni
Gojek
xy
Depop
ea
JamesDelivery
hq
Magicbricks
qo
Moneylion
lt
BitClout
hy
Ininal
zm
OfferUp
bp
GoFundMe
ph
SnappFood
vn
Yaay
qc
Праймериз 2020
fi
Dundle
sh
ВкусВилл
za
JDcom
pq
CDkeys
iz
Global24
oc
DealShare
io
ЗдравСити
ti
cryptocom
ge
Paytm
xd
Tokopedia
es
iQIYI
yl
Yalla
nf
Netflix
sk
Skroutz
we
ДругВокруг
vd
Betfair
zs
Bilibili
dy
Zomato
tk
МВидео
tg
Telegram
rj
Детский мир
qf
RedBook
yi
Yemeksepeti
yu
Xiaomi
qr
MEGA
wf
YandexGo
bo
Wise
zr
Papara
rp
hamrahaval
bd
X5ID
je
Nanovest
ka
Shopee
xs
GroupMe
gu
Fora
gv
Humta
mf
Weidian
sb
Lamoda
db
ezbuy
va
SportGully
xr
Tango
mi
Zupee
kr
Eyecon
yg
CourseHero
he
Mewt
au
Haraj
ab
Alibaba
iq
icq
ys
ZCity
hr
JKF
ip
Burger King
aj
OneAset
cd
SpotHit
zf
OnTaxi
gm
Mocospace
sv
Dostavista
go
Google,youtube,Gmail
ls
Careem
li
Baidu
ss
Hezzl
pu
Justdating
wh
TanTan
dh
eBay
fb
wl
YouGotaGift
sf
SneakersnStuff
oh
MapleSEA
xe
GalaxyChat
kn
Verse
rv
Kotak811
mm
Microsoft
nr
Tosla
pm
AOL
km
Rozetka
kt
KakaoTalk
zv
Digikala
uz
OffGamers
df
Happn
zz
Dent
pr
Trendyol
mt
Steam
jb
Wing Money
oz
Poshmark
wx
Apple
le
E bike Gewinnspiel
pt
Bitaqaty
tp
IndiaGold
et
Clubhouse
vi
Viber
fs
Şikayet var
oq
Vlife
dv
NoBroker
kb
kufarby
oi
Tinder
ds
Discord
hc
MOMO
cf
irancell
dw
Divar
ta
Wink
ya
Яндекс
yb
Квартплата+
ee
Twilio
gx
Hepsiburadacom
ey
miloan
en
Hermes
sw
NCsoft
uh
Yubo
pd
IFood
dt
Delivery Club
dp
ProtonMail
vv
Seosprint
dg
Mercari
lp
Algida
uc
Tatneft
vg
ShellBox
iv
Inboxlv
im
Imo
ji
Monobank
qe
GG
ej
MrQ
jj
Aitu
gp
Ticketmaster
fu
Snapchat
qn
Blued
ug
Fiqsy
kf
jm
mzadqatar
am
Amazon
ue
Onet
fx
PGbonus
qk
Bit
dn
Paxful
lk
PurePlatfrom
uj
СhampionСasino
kp
HQ Trivia
fz
KFC
fw
99acres
xz
paycell
tx
Bolt
bn
Alfagift
yn
Allegro
ql
CMTcuzdan
jl
Hopi
lb
Mailru Group
be
СберМегаМаркет
eo
Sizeer
wg
Skout
ra
KeyPay
re
Coinbase
po
premium.one
ij
Revolut
uf
Eneba
hz
Drom
td
ChaingeFinance
rd
Lenta
vo
Brand20ua
gf
GoogleVoice
nn
Giftcloud
wc
Craigslist
uo
CafeBazaar
el
Bisu
zn
Biedronka
bb
LazyPay
zh
Zoho
mr
Fastmail
os
Dhani
zw
Quack
cp
Uklon
dk
Pairs
tm
Akulaku
ly
Olacabs
ce
mosru
gw
CallApp
pf
pof.com
vz
Hinge
xh
OVO
gk
AptekaRU
ve
Dream11
cc
Quipp
yf
Citymobil
xk
DiDi
il
IQOS
tl
Truecaller
xv
Wish
mk
LongHu
xl
Wmaraci
yz
Около
tf
Noon
yy
Venmo
kx
Vivo
ft
Букмекерские
iy
FoodHub
gb
YouStar
xj
СберМаркет
wp
163СOM
jf
Likee
ll
888casino
ig
lq
Potato
iu
Bykea
vm
OkCupid
eu
LiveScore
gc
TradingView
of
Urent
ax
CrefisaMais
uu
Wildberries
pl
Перекресток
ny
Pyro Music
cr
TenChat
qb
Payberry
vj
Stormgain
rk
Fotka
wj
1хbet
kz
NimoTV
tj
dbrUA
cs
AgriDevelop
ww
BIP
mh
Ашан
ik
GuruBets
od
FWDMAX
az
CityBase
yp
Payzapp
ku
RoyalWin
hx
AliExpress
bf
Keybase
bv
Metro
wt
IZI
hw
AliPay
ry
McDonalds
ch
Pocket52
ym
Юла
jr
Самокат
qa
MyFishka
qh
Oriflame
np
Siply
gd
Surveytime
un
humblebundle
sg
OZON
tt
Ziglu
vp
Kwai
gz
LYKA
vy
Meta
cu
炙热星河
vc
Banqi
de
Karusel
rm
Faberlic
ib
Immowelt
ua
BlaBlaCar
lf
TikTok/Douyin
px
Nifty
sj
HandyPick
co
Rediffmail
sz
Pivko24
ju
Indomaret
op
MIRATORG
dx
Powerkredite
gt
Gett
zl
Airtel
gi
Hotline
ki
99app
ew
Nike
th
WestStein
ol
KazanExpress
zg
Setel
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