Receiving sms - API Documentation

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"

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.

getBalance

To check the balance

https://sms-activation-service.com/stubs/handler_api?api_key=APIKEY&action=getBalance&lang=LANG

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

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

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

Service ID

name

Вконтакте

Service name

price

29.88

Actual price

quantity

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

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

Not enough balance on the API account

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

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

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

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

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

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

Name

Available operators

Russia

aiva, any, beeline, center2m, danycom, ezmobile, lycamobile, matrix, megafon, motiv, mts, mtt, mtt_virtual, rostelecom, sber, simsim, tele2, tinkoff, ttk, winmobile, yota,

Ukraine

3mob, any, intertelecom, kyivstar, life, lycamobile, mts, utel, vodafone,

Kazakhstan

activ, altel, any, beeline, kcell, tele2,

China

any, chinamobile, china_unicom, unicom,

England (UK)

any, cmlink, ee, ezmobile, lebara, lycamobile, o2, orange, talk_telecom, three, tmobile, vectone, vodafone,

Myanmar

any, ooredoo, telenor,

Indonesia

any,

Malaysia

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

Kenya

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

Tanzania

airtel, any, tigo, vodacom,

Viet Nam

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

Kyrgyzstan

any, beeline, megacom, o!,

USA (Virtual)

any, cellular, tmobile,

Israel

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

Hong Kong (China)

any, chinamobile, csl_mobile, imc, smartone, three, unicom,

Poland

aero2, any, e_telko, klucz, lycamobile, netia, orange, play, plus, tmobile,

Philippines

any, globe_telecom, smart, tm,

Madagascar

any,

Dem. Congo

africel, airtel, any, orange, vodacom,

Nigeria

airtel, any, etisalat, glomobile, mtn,

Macau

any,

Egypt

any, etisalat, orange, vodafone,

India

any,

Ireland

48mobile, any, lycamobile, tesco,

Cambodia

any, metfone,

Laos

any, etl, telekom, tplus, unitel,

Haiti

any, natcom,

Côte d'Ivoire

any, moov, mtn, orange,

Gambia

africel, any, comium, gamcel, qcell,

Serbia

any, mobtel, mts, vip,

Yemen

any, mtn, sabafon, yemen_mobile,

SOUTH AFRICA

any, cell_c, lycamobile, mtn, telkom, vodacom,

Romania

any, digi, lycamobile, my_avon, orange, runex_telecom, telekom, vodafone,

Colombia

any, claro, movistar,

Estonia

any, elisa, goodline, super, tele2, topconnect,

Azerbaijan

any,

Canada

any, cellular, fido, lucky, rogers, telus,

Morocco

any, iam, inwi, itissalat, orange,

Ghana

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

Argentina

any, claro, movistar,

Uzbekistan

any, beeline, humans, mobiuz, mts, ucell, uzmobile,

Cameroon

any, mtn, nexttel, orange,

Chad

airtel, any, salam, tigo,

Germany

any, fonic, lebara, lycamobile, o2, ortel_mobile, telekom, vodafone,

Lithuania

any, bite, tele2, telia,

Croatia

a1, any, tele2, tmobile, tomato,

Sweden

any, comviq, lycamobile, tele2, telenor, telia, three, vectone, vodafone,

Iraq

any, asiacell, korek, zain,

Netherlands

any, kpn, lebara, lycamobile, l_mobi, tmobile, vodafone,

Latvia

any, bite, lmt, tele2,

Austria

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

Belarus

any, life, mdc, mts,

Thailand

ais, any, dtac, truemove,

Saudi Arabia

any,

Mexico

any, telcel,

Taiwan

any, chunghwa, fareast,

Spain

altecom, any, euskaltel, lebara, llamaya, lycamobile, movistar, orange, vodafone, yoigo, you_mobile,

Iran

any,

Algeria

any, djezzy, mobilis, ooredoo,

Slovenia

any,

Bangladesh

any,

Senegal

any, expresso, free, orange,

Turkey

any, turkcell,

Czech Republic

any, o2, tmobile, vodafone,

Sri Lanka

airtel, any, etisalat,

Peru

any,

Pakistan

any, jazz, ptcl, sco, telenor, ufone, zong,

New Zealand

2degree, any, vodafone,

Guinea

any, cellcom, mtn, orange, sotelgui, telecel,

Mali

any, malitel, orange, telecel,

Venezuela

any,

Ethiopia

any,

Mongolia

any, beeline,

Brazil

algartelecom, any, claro, correios_celular, oi, tim, vivo,

Afghanistan

any, salaam,

Uganda

airtel, any, k2_telecom, lycamobile, mtn, orange, smart, smile, uganda_telecom,

Angola

any,

Cyprus

any, cablenet, cyta, epic, lemontel, primetel, vectone,

France

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

New Guinea

any,

Mozambique

any,

Nepal

any,

Belgium

any,

Bulgaria

a1, any, telenor, vivacom,

Hungary

any,

Moldova

any, idc, moldcell, orange, unite,

Italy

any,

Paraguay

any,

Honduras

any, claro,

Tunisia

any, ooredoo, orange, tunicell,

Nicaragua

any, movistar,

Timor-Leste

any,

Bolivia

any,

Costa Rica

any,

Guatemala

any, claro, movistar, tigo,

UNITED ARAB EMIRATES

any,

Zimbabwe

any, econet,

Puerto Rico

any,

Sudan

any,

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

Name

Вконтакте

Ok.ru

Viber

WeChat

Google,youtube,Gmail

avito

facebook

Twitter

Uber

Киви

Gett

OLX

Instagram

Hezzl

Юла

Mail.ru

Microsoft

Airbnb

Line msg

Yahoo

ДругВокруг

X5ID

HQ Trivia

Delivery Club

Яндекс

Steam

Tinder

Mamba

Dent

KakaoTalk

AOL

Tencent QQ

Магнит

pof.com

Yalla

kolesa.kz

premium.one

Naver

Netflix

icq

Onlinerby

kufarby

Imo

Michat

Discord

Seosprint

Monobank

TikTok/Douyin

Ukrnet

Skout

EasyPay

Q12 Trivia

Pyro Music

Wolt

CliQQ

ssoidnet

Zoho

Ticketmaster

Amazon

Olacabs

Rambler

ProtonMail

NRJ Music Awards

Citymobil

MIRATORG

PGbonus

MEGA

СпортМастер

Careem

BIGO LIVE

MyMusicTaste

Snapchat

Keybase

OZON

Wildberries

BlaBlaCar

Alibaba

Inboxlv

Nttgame

Surveytime

Mylove

mosru

Truecaller

Globus

Bolt

Shopee

Перекресток

Burger King

Prom

Alipay/Alibaba

Karusel

IVI

inDriver

Happn

RuTube

Magnolia

Foodpanda

Weibo

BillMill

Quipp

Okta

JDcom

MTS CashBack

Fiqsy

KuCoinPlay

Papara

Wish

Icrypex

PaddyPower

Baidu

Dominos Pizza

paycell

Lenta

Payberry

Drom

GlobalTel

Deliveroo

Socios

Wmaraci

Yemeksepeti

Nike

myGLO

YouStar

РСА

RosaKhutor

eBay

Квартплата+

Grindr

OffGamers

Hepsiburadacom

Coinbase

dbrUA

PayPal

hily

SneakersnStuff

Dostavista

23red

Blizzard

ezbuy

CoinField

Airtel

YandexGo

MrGreen

Rediffmail

miloan

Paytm

Dhani

CMTcuzdan

Mercado

DiDi

Monese

Kotak811

Hopi

Trendyol

Justdating

Pairs

Touchance

SnappFood

NCsoft

Tosla

Ininal

Paysend

CDkeys

AVON

dodopizza

McDonalds

E bike Gewinnspiel

JKF

MyFishka

Craigslist

Foody

Grab

Zalo

LiveScore

888casino

Gamer

Huya

WestStein

Tango

Global24

МВидео

Sheerid

99app

CAIXA

OfferUp

Swvl

Haraj

Taksheel

hamrahaval

Gamekit

Şikayet var

Getir

irancell

Alfa

Disney Hotstar

Agroinform

humblebundle

Faberlic

CafeBazaar

cryptocom

Gittigidiyor

mzadqatar

Algida

Cita Previa

Potato Chat

Bitaqaty

Праймериз 2020

Amasia

Dream11

Oriflame

Bykea

Immowelt

Digikala

Wing Money

Yaay

GameArena

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

Ашан

Picpay

Blued

SpotHit

Brand20ua

IQOS

Powerkredite

Bisu

Paxful

PurePlatfrom

Banqi

1хbet

Mobile01

Aitu

Adidas

Самокат

Верный

Humta

Divar

Carousell

MOMO

Eneba

Verse

Taobao

1688

OnTaxi

Hotline

Tatneft

RRSA

Douyu

Uklon

Moneylion

Apple

Clubhouse

Nifty

PingPong

Mailru Group

Банки

BitClout

Skroutz

MapleSEA

Rozetka

GalaxyWin

Ziglu

Likee

CityBase

Allegro

YouGotaGift

Lazada

TradingView

Fiverr

Gabi

Kwai

Детский мир

Yubo

iQIYI

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

Glovo

IFood

Quack

Mocospace

Dundle

Switips

Faceit

LYKA

Paysafecard

Onet

LightChat

GoFundMe

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