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:

Пример ответа:

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:

Пример ответа в JSON:

[{"id":0,"name":"Россия","operators":{"any":"any","tele2":"tele2","tinkoff":"tinkoff","ttk":"ttk","yota":"yota"}},{"id":1,"name":"Украина","operators":{"any":"any","kyivstar":"kyivstar","life":"life","lycamobile":"lycamobile","mts":"mts","utel":"utel","vodafone":"vodafone"}}]

Field

Example

Description

id

0

ID страны

name

Россия

Название страны

operators

["operators":{"aiva":"aiva", "any":"any"}]

Массив с ID операторов

Field

Type

Description

api_key

string

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

operator

string

Сотовый оператор номер которого необходимо получить см. "Список стран"

country

integer

ID Страны номер которой необходимо получить см. "Список стран"

lang

string

Localization ru or en

Server response:

Пример ответа в JSON:

[{"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

ID сервиса

name

Вконтакте

Название сервиса

price

29.88

Актуальная цена

quantity

19

Количество номеров

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

Сервис, номер для которого необходимо получить см. "Список сервисов"

operator

string

Сотовый оператор номер которого необходимо получить см. "Список стран"

country

integer

ID Страны номер которой необходимо получить см. "Список стран"

lang

string

Localization ru or en

Server response:

Server response

Example

Description

NO_BALANCE

NO_BALANCE

Недостаточно баланса на аккаунте API

NO_NUMBERS

NO_NUMBERS

Нет номеров с заданными параметрами, попробуйте позже, или поменяйте оператора, страну.

ACCESS_NUMBER:ID:NUMBER

ACCESS_NUMBER:234242:79991728822

Получили номер, ID активации - ID, сам номер с кодом страны - 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 - Запросить еще одну смс

6 - Завершить активацию

8 - Отменить заказ

Server response:

Server response

Description

NO_BALANCE

Недостаточно баланса на аккаунте API

ACCESS_CANCEL

Активация отменена

ACCESS_RETRY_GET

Ожидаем новое смс

ACCESS_ACTIVATION

Активация успешно завершена

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

Ожидаем прихода смс

STATUS_CANCEL

активация отменена

STATUS_OK:CODE

Код получен (где CODE - код активации)

Annex 1. List of countries

ID

Наименование

Доступные операторы

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, talk_telecom, three, tmobile, vectone, vodafone,

5

Myanmar

any, telenor,

6

Indonesia

any, axis, indosat, telkomsel, three,

7

Malaysia

any, celcom, digi, hotlink, u_mobile, xox,

8

Kenya

airtel, any, econet, orange, safaricom, telkom,

9

Tanzania

any,

10

Viet Nam

any, itelecom, mobifone, vietnamobile, viettel, vinaphone,

11

Kyrgyzstan

any, beeline, megacom, o!,

12

USA

any, cellular, tmobile,

13

Israel

019mobile, any, golan_telecom, home_cellular, hot_mobile, jawwal, ooredoo, orange, pelephone, rami_levy,

14

Hong Kong

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

any, lycamobile,

24

Cambodia

any,

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 (virtual)

any, cellular, lucky, rogers,

37

Morocco

any, iam, inwi, itissalat, orange,

38

Ghana

airtel, any, glomobile, millicom, mtn, vodafone,

39

Argentina

any,

40

Uzbekistan

any, beeline, 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, tele2, telia,

45

Croatia

a1, any, tele2, tmobile,

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, tele2,

50

Austria

a1, any, orange, telering, three, tmobile,

51

Belarus

any, life, mdc, mts,

52

Thailand

ais, any, dtac, truemove,

53

Saudi Arabia Saudi Arabia

any,

54

Mexico

any, telcel,

55

Taiwan

any, chunghwa, fareast,

56

Spain

any, lebara, lycamobile, orange, you_mobile,

57

Iran

any, aptel, azartel, hamrah_e_aval, irancell, rightel, samantel, shatel, taliya,

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

any,

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, cyta, epic, lemontel, primetel, vectone,

78

France

any, lebara, lycamobile, orange, sfr, syma_mobile, vectone,

79

New Guinea

any,

80

Mozambique

any,

81

Nepal

any,

82

Belgium

any,

83

Bulgaria

any,

84

Hungary

any,

85

Moldova

any, moldcell, orange, unite,

86

Italy

any,

87

Paraguay

any,

88

Honduras

any,

89

Tunisia

any,

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,

102

Libya

any,

103

Jamaica

any, digi,

104

Trinidad and Tobago

any,

105

Ecuador

any,

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, 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, 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,

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,

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,

182

Japan

any,

183

Northern Macedonia

any,

184

Republic of Seychelles

any,

185

New Caledonia

any,

186

Cape Verde

any,

187

USA

any, lycamobile, tmobile,

190

South Korea

any,

189

Fiji

any,

195

Bermuda

any,

Annex 2. Service list

ID

Наименование

fx

PGbonus

zl

Airtel

fy

Mylove

sb

Lamoda

yb

Квартплата+

qo

Moneylion

nv

Naver

ea

JamesDelivery

fe

CliQQ

mu

MyMusicTaste

bt

Alfa

rl

inDriver

jh

PingPong

tg

Telegram

wx

Apple

zy

Nttgame

fd

Mamba

xf

LightChat

ji

Monobank

pu

Justdating

zv

Digikala

ee

Twilio

np

Siply

vk

Вконтакте

cx

Icrypex

mr

Fastmail

da

MTS CashBack

en

Hermes

vn

Yaay

ll

888casino

lq

Potato

gl

GlobalTel

fj

Potato Chat

un

humblebundle

zs

Bilibili

ak

Douyu

rp

hamrahaval

ke

Эльдорадо

ou

Gabi

up

Magnolia

mg

Магнит

xz

paycell

bj

Вита экспресс

bl

BIGO LIVE

kf

Weibo

yf

Citymobil/Urent

zo

Kaggle

oh

MapleSEA

vx

HeyBox

ij

Revolut

oz

Poshmark

co

Rediffmail

eo

Sizeer

ph

SnappFood

fm

Touchance

bf

Keybase

jq

Paysafecard

zd

Zilch

gw

CallApp

fb

facebook

bz

Blizzard

kp

HQ Trivia

jb

Wing Money

wb

WeChat

ew

Nike

mn

RRSA

xq

MPL

uj

СhampionСasino

ku

RoyalWin

ka

Shopee

tx

Bolt

je

Nanovest

my

CAIXA

dn

Paxful

sk

Skroutz

ui

RuTube

lt

BitClout

dh

eBay

wj

1хbet

es

iQIYI

jj

Aitu

zh

Zoho

cd

SpotHit

gp

Ticketmaster

wn

GameArena

md

Банки

ub

Uber

la

ssoidnet

tt

Ziglu

hn

1688

af

GalaxyWin

nf

Netflix

qq

Tencent QQ

zr

Papara

td

ChaingeFinance

yp

Payzapp

tp

IndiaGold

ge

Paytm

pd

IFood

po

premium.one

pt

Bitaqaty

go

Google,youtube,Gmail

pm

AOL

yo

Amasia

nr

Tosla

uf

Eneba

vp

Kwai

uh

Yubo

dk

Pairs

vf

Q12 Trivia

qw

Киви

au

Haraj

ny

Pyro Music

zm

OfferUp

ry

McDonalds

dt

Delivery Club

uz

OffGamers

qa

MyFishka

wa

Whatsapp

ly

Olacabs

yu

Xiaomi

zz

Dent

qj

Whoosh

tn

LinkedIN

qu

Agroinform

uy

Meliuz

rj

Детский мир

kl

kolesa.kz

fu

Snapchat

ud

Disney Hotstar

ob

Onlinerby

zg

Setel

uk

Airbnb

ss

Hezzl

ga

Roposo

yg

CourseHero

vy

Meta

ym

Юла

ri

BillMill

gt

Gett

zf

OnTaxi

li

Baidu

va

SportGully

am

Amazon

ad

Iti

lv

Megogo

ev

Picpay

pf

pof.com

tj

dbrUA

tl

Truecaller

kn

Verse

pl

Перекресток

qd

Taobao

me

Line msg

hj

Столото

iz

Global24

dm

Iwplay

sg

OZON

qi

23red

ww

BIP

vm

OkCupid

nb

Верный

lf

TikTok/Douyin

rx

Sheerid

lb

Mailru Group

gz

LYKA

wt

IZI

le

E bike Gewinnspiel

tm

Akulaku

db

ezbuy

nn

Giftcloud

gi

Hotline

il

IQOS

jr

Самокат

ki

99app

wc

Craigslist

gv

Humta

xs

GroupMe

mc

Michat

qr

MEGA

lj

Santander

hg

Switips

hw

AliPay

kw

Foody

ae

myGLO

iu

Bykea

iq

icq

xh

OVO

hy

Ininal

gb

YouStar

et

Clubhouse

be

СберМегаМаркет

yz

Около

xj

СберМаркет

sh

ВкусВилл

lr

Okta

re

Coinbase

vw

CoinField

ey

miloan

ti

cryptocom

de

Karusel

tr

Paysend

vc

Banqi

wh

TanTan

jl

Hopi

vv

Seosprint

cq

Mercado

mm

Microsoft

dy

Zomato

xr

Tango

lp

Algida

ol

KazanExpress

bd

X5ID

kc

Vinted

vi

Viber

jf

Likee

qm

RosaKhutor

fs

Şikayet var

rr

Wolt

ok

Ok.ru

jg

Grab

hz

Drom

si

Cita Previa

we

ДругВокруг

qz

Faceit

ua

BlaBlaCar

gm

Mocospace

dl

Lazada

hr

JKF

eu

LiveScore

yl

Yalla

sw

NCsoft

ip

Burger King

hb

Twitch

ni

Gojek

tf

Noon

ts

PayPal

oi

Tinder

wk

Mobile01

cw

PaddyPower

lw

MrGreen

bv

Metro

cc

Quipp

ue

Onet

pa

Gamekit

wl

YouGotaGift

zk

Deliveroo

iv

Inboxlv

cn

Fiverr

qn

Blued

sl

СберАптека

qb

Payberry

qf

RedBook

ib

Immowelt

ma

Mail.ru

tw

Twitter

py

Monese

qc

Праймериз 2020

ft

Букмекерские

qh

Oriflame

ql

CMTcuzdan

km

Rozetka

ya

Яндекс

cf

irancell

th

WestStein

wg

Skout

hx

AliExpress

ch

Pocket52

cy

РСА

bp

GoFundMe

uu

Wildberries

gj

Carousell

lk

PurePlatfrom

nu

Stripe

mt

Steam

sq

KuCoinPlay

ej

MrQ

mb

Yahoo

og

Okko

nz

Foodpanda

yn

Allegro

sf

SneakersnStuff

za

JDcom

ff

AVON

el

Bisu

fi

Dundle

ce

mosru

nk

Gittigidiyor

im

Imo

rm

Faberlic

yw

Grindr

pg

NRJ Music Awards

gd

Surveytime

xe

GalaxyChat

tq

Swvl

pq

CDkeys

rt

hily

ug

Fiqsy

an

Adidas

rz

EasyPay

qe

GG

kt

KakaoTalk

kb

kufarby

kx

Vivo

ul

Getir

vg

ShellBox

os

Dhani

cs

AgriDevelop

cp

Uklon

pr

Trendyol

ig

Instagram

uo

CafeBazaar

hm

Globus

aq

Glovo

ve

Dream11

px

Nifty

sj

HandyPick

zw

Quack

ls

Careem

jc

IVI

cm

Prom

mj

Zalo

hu

Ukrnet

wf

YandexGo

ed

Gamer

xl

Wmaraci

tc

Rambler

ab

Alibaba

rv

Kotak811

ds

Discord

xk

DiDi

ra

KeyPay

dz

Dominos Pizza

df

Happn

az

CityBase

rd

Lenta

dx

Powerkredite

hl

Band

sv

Dostavista

xv

Wish

yi

Yemeksepeti

gx

Hepsiburadacom

sn

OLX

pz

Lidl

pp

Huya

kr

Eyecon

wp

163СOM

hc

MOMO

ca

SuperS

zn

Biedronka

kz

NimoTV

vd

Betfair

av

avito

ot

Not in list

hk

4Fun

sd

dodopizza

yk

СпортМастер

nq

Trip

jm

mzadqatar

st

Auchan

vo

Brand20ua

tk

МВидео

ia

Socios

op

MIRATORG

bo

Wise

uc

Tatneft

io

ЗдравСити

ei

Taksheel

gc

TradingView

dw

Divar

fz

KFC

dp

ProtonMail

lx

DewuPoison

Possible error

Server response

Description

BAD_ACTION

Неправильное формирование запроса

BAD_KEY

Неверный API-ключ

BAD_LANG

Неверная локазация, принимаются ru или en

NO_ACTIVATION

ID активации не существует

ERROR_SQL

Ошибка базы SQL-сервера

ERROR_API

Ошибка обработки