Attention! We have moved to a new domain. If you worked with the API you need to change the domain from the old one to the new one "sms-activation-service.com"
Open navigation Close navigation
  • 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-activation-service.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-activation-service.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, ooredoo, 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, claro, movistar,

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,

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, jazz, ptcl, sco, telenor, ufone, zong,

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,

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

vi

Viber

tg

Telegram

wb

WeChat

go

Google,youtube,Gmail

av

avito

fb

facebook

tw

Twitter

ub

Uber

qw

Киви

gt

Gett

sn

OLX

ig

Instagram

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

LinkedIN

qq

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/Alibaba

de

Karusel

jc

IVI

rl

inDriver

df

Happn

ui

RuTube

up

Magnolia

nz

Foodpanda

kf

Weibo

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

Telegram 2.0

fk

BLIBLI

cg

Gemgala

fv

Vidio

xw

Taki

nl

Myntra

uw

Kirana

fo

MobiKwik

dr

OpenAI

ai

CELEBe

ht

Bitso

nw

Ximalaya

hh

Uplay

xx

Joyride

br

Вкусно и Точка

cb

Bazos

ko

AdaKami

kj

YAPPY

ky

SpatenOktoberfest

mx

SoulApp

vs

WinzoGame

sr

Starbucks

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