Open navgation Close navgation
  • Description of the API protocol
  • To check the balance
    getBalance
  • Get all countries and operators available to them
    getCountryAndOperators
  • Get current prices and number of rooms
    getServicesAndCost
  • Room booking
    getNumber
  • To change the status
    setStatus
  • To obtain the current status
    getStatus
  • To obtain the current status
    getCurrentActivationsList
  • Annex 1. List of countries
  • Annex 2. Service list
  • Possible error

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_api

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.

Field

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=LANG

Field

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

Field

Type

Description

api_key

string

Your API key provides access to paid services. The API key should be kept secret

operator

string

The cellular operator whose number is to be obtained see. "Country List"

country

integer

The ID of the country whose number you want to get, see "Country List"

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

Field

Type

Description

api_key

string

Your API key provides access to paid services. The API key should be kept secret

action

string

Method name

service

string

Service number for which you want to get see. "Services List"

operator

string

The cellular operator whose number is to be obtained see. "Country List"

country

integer

The ID of the country whose number you want to get, see "Country List"

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

Field

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

Field

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)

Field

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

WeChat

ne

Coindcx

uk

Airbnb

vk

Вконтакте

vx

HeyBox

nv

Naver

sn

OLX

tq

Swvl

dz

Dominos Pizza

hn

1688

tr

Paysend

qq

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

Twitter

gl

GlobalTel

fr

Dana

fe

CliQQ

jc

IVI

tn

LinkedIN

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

facebook

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

Weibo

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

Instagram

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