Receiving sms - API Documentation

Long term numbers rental Rent for 20 minutes Referral program API Customer Service

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 available countries and mobile operators for countries.

getCountryAndOperators
Get current prices, the number of online numbers with SMS delivery statistics by service/site and a list of minimum prices by country.

getServicesAndCost
Get current prices and number of rooms with statistics

getServicesAndCostWithStatistics
Number order

getNumber
To change the status

setStatus
To find out the current status of a booked number

getStatus
List of current activation

getCurrentActivationsList
Possible error
Annex 1. List of countries
Annex 2. Service list

Receive sms online - API Documentation

API is a communication protocol between your software and our server of temporary phone numbers for sms activations and verifications.

API is needed to automate the process of ordering temporary numbers and receiving sms messages on your side. All requests (POST and GET are supported) should go to

https://sms-activation-service.com/stubs/handler_api

Attention

All requests must contain API key - parameter "api_key", Be sure to specify the parameter "lang" depending on what currency your balance is in. Available ruble and dollar balance (ru/en). Method name - parameter "action". RPS limits - 8 requests per second.

Useful options for API clients.

Find out in which country the cheapest temporary numbers under X service? "See where the cheapest numbers are."
View the percentage of successful SMS received by other users. "Learn more about SMS deliverability statistics"
Set the maximum purchase price so as not to get a sharp price increase due to high demand "Learn more about how to limit the price of buying numbers."

Get the API key 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 available countries and mobile operators for countries.

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 code (ID)

name

Russia

Country name

operators

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

Array with operator codes

getServicesAndCost

Get current prices, the number of online numbers with SMS delivery statistics by service/site and a list of minimum prices by country.

https://sms-activation-service.com/stubs/handler_api?api_key=APIKEY&action=getServicesAndCost&country=COUNTRY&operator=OPERATOR&service=SERVICE&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 country code of the country from which you want to receive the number for sms. See. "Country List"

country

integer

Country code of the country from which you want to receive the number for sms, see "Country List"

service

string

Service number for which you want to get see. "Services 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 (site) code for API

name

Вконтакте

Service name

price

29.88

Actual price

quantity

Number of numberss

getServicesAndCostWithStatistics

Get the current prices and number of numbers with statistics of sms delivery by service/sites and a list of minimum prices by country.

https://sms-activation-service.com/stubs/handler_api?api_key=APIKEY&action=getServicesAndCostWithStatistics&country=COUNTRY&operator=OPERATOR&service=SERVICE&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 country code of the country from which you want to receive the number for sms. See. "Country List"

country

integer

Country code of the country from which you want to receive the number for sms, see "Country List"

service

string

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

lang

string

Localization ru or en

Server response:

Sample JSON response:

[{"id":"tg","name":"Telegram","price":0.71,"quantity":1429,"deliverability":"25.82","cheap_prices_countries":[{"country_id":6,"country_name":"Indonesia","price":"0.20"},{"country_id":10,"country_name":"Viet Nam","price":"0.33"},{"country_id":93,"country_name":"Costa Rica","price":"0.36"},{"country_id":57,"country_name":"Iran","price":"0.36"},{"country_id":61,"country_name":"Senegal","price":"0.37"}]]

Field

Example

Description

Service (site) code for API

name

Вконтакте

Service name

price

29.88

Actual price

quantity

Number of numberss

deliverability

12.71

Percentage of SMS deliverability by service/site

cheap_prices_countries

{"country_id":6,"country_name":"Indonesia","price":"0.20"}

List of minimum prices by country

getNumber

Number order

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 country code of the country from which you want to receive the number for sms. See. "Country List"

country

integer

Country code of the country from which you want to receive the number for sms, 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

You get the order ID, ordered temporary number with country code.

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

Order ID received when ordering a temporary number

status

integer

Status that must be transferred to the order

lang

string

Localization ru or en

Available statuses:

3 - Request another sms

6 - Finish work with the ordered number

8 - Cancel order (only if SMS did not arrive)

Server response:

Server response

Description

NO_BALANCE

Not enough balance on the API account

ACCESS_CANCEL

Order cancelled

ACCESS_RETRY_GET

Waiting for new SMS

ACCESS_ACTIVATION

The order has been successfully completed

CANNOT_BEFORE_2_MIN

You can't cancel before 2 minutes after ordering a numbers

getStatus

To find out the current status of a booked number

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

Order ID received when ordering a temporary number

lang

string

Localization ru or en

Server response:

Server response

Description

STATUS_WAIT_CODE

Wait for a text message from the sender

STATUS_CANCEL

Order cancelled

STATUS_OK:CODE

Code received (where CODE - verification code from sms

getCurrentActivationsList

List of current activation

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 by which we filter (available - 0 (new, waiting for sms) | 1 (completed) | 2 (cancelled) | 3 (received sms) | 4 (awaiting an extra 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 } ]

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

Order ID does not exist or rental time has expired

ERROR_SQL

SQL Server database error

ERROR_API

Processing error

REQUEST_LIMIT

Request limit per second

Annex 1. List of countries

Country code (ID)

Сountry name

Available mobile operators

Russia

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

Ukraine

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

Kazakhstan

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

China

any, china_unicom, chinamobile, unicom

Philippines

any, globe_telecom, smart, tm

Myanmar

any, mpt, mytel, ooredoo, telenor

Indonesia

any, axis, indosat, smartfren, telkomsel, three

Malaysia

any, celcom, digi, hotlink, tune_talk, u_mobile, xox, yes

Kenya

airtel, any, econet, orange, safaricom, telkom

Tanzania

airtel, any, halotel, tigo, ttcl, vodacom

Viet Nam

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

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

a2_mobile, aero2, any, e_telko, heyah, klucz, lycamobile, netia, nju, orange, play, plus, plush, red_bull_mobile, tmobile

England (UK)

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

Madagascar

any

Dem. Congo

africel, airtel, any, orange, vodacom

Nigeria

airtel, any, etisalat, glomobile, mtn

Macau

3macao, any

Egypt

any, etisalat, orange, vodafone

India

airtel, any

Ireland

48mobile, any, cablenet, 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

a1, any, mobtel, mts, vip

Yemen

any, mtn, sabafon, yemen_mobile

SOUTH AFRICA

any, cell_c, lycamobile, mtn, telkom, vodacom

Romania

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

Colombia

any, claro, movistar, tigo, virgin, wom

Estonia

any, elisa, goodline, super, tele2, topconnect

Azerbaijan

any, azerfon, humans

Canada

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

Morocco

any, iam, inwi, itissalat, orange

Ghana

airtel, any, glomobile, millicom, mtn, vodafone

Argentina

any, claro, movistar, personal, tuenti

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, telemach, tmobile, tomato

Sweden

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

Iraq

any, asiacell, korek, zain

Netherlands

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

Latvia

any, bite, lmt, tele2, xomobile

Austria

a1, any, eety, hot_mobile, lidl, lycamobile, orange, telering, three, tmobile, yesss

Belarus

any, best, life, mdc, mts

Thailand

ais, any, dtac, truemove

Saudi Arabia

any

Mexico

any, telcel

Taiwan

any, chunghwa, fareast

Spain

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

Iran

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

Algeria

any, djezzy, mobilis, ooredoo

Slovenia

a1, any, telekom, telemach

Bangladesh

any

Senegal

any, expresso, free, orange

Turkey

any, turk_telekom, turkcell, vodafone

Czech Republic

any, kaktus, o2, tmobile, vodafone

Sri Lanka

airtel, any, dialog, etisalat, hutch, sltmobitel

Peru

any, movistar

Pakistan

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

New Zealand

2degree, any, one_nz, skinny, spark, vodafone, warehouse

Guinea

any, cellcom, mtn, orange, sotelgui, telecel

Mali

any, malitel, orange, telecel

Venezuela

any

Ethiopia

any, mtn

Mongolia

any, beeline

Brazil

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

Afghanistan

any, salaam

Uganda

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

Angola

africel, any, unitel

Cyprus

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

France

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

New Guinea

any

Mozambique

any, vodacom

Nepal

any

Belgium

any, bandwidth, base, infrabel, lycamobile, nethys, orange, proximus, vectone

Bulgaria

a1, any, telenor, vivacom, yettel

Hungary

any, tmobile, vodafone, yettel

Moldova

any, idc, moldcell, orange, unite

Italy

any, digi, ho, kena_mobile, lycamobile, optima, tim, vodafone, wind

Paraguay

any, claro, personal

Honduras

any, claro

Tunisia

any, ooredoo, orange, tunicell

Nicaragua

any, movistar

Timor-Leste

any, telemor, telkomcel, timor_telecom

Bolivia

any

Costa Rica

any

Guatemala

any, claro, movistar, tigo

UNITED ARAB EMIRATES

any, du

Zimbabwe

any, econet

Puerto Rico

any

Sudan

any, mtn, sudani_one, zain

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

a1, any, hej

109

Dominican Republic

altice, any, claro, viva

111

Qatar

any

112

Panama

any

113

Cuba

any, cubacel

114

Mauritania

any, chinguitel, mattel, mauritel

115

Sierra Leone

africel, airtel, any, qcell

116

Jordan

any, orange, umniah, xpress, zain

117

Portugal

any, lebara, lycamobile, nos, vodafone

118

Barbados

any

119

Burundi

africel, any, econet, lacell, telecel, viettel

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

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

airtel, any, mtn

141

Slovakia

any, o2

142

Suriname

any

143

Tajikistan

any, indigo

144

Monaco

any

145

Bahrain

any

146

Reunion

any

147

Zambia

airtel, any, mtn, zamtel

148

Armenia

any, team, viva, vivo

149

Somalia

any

150

Congo

airtel, any

151

Chile

any, claro, entel, movistar, wom

152

Burkina Faso

airtel, any, onatel, telecel

153

Lebanon

alfa, any, ogero, touch

154

Gabon

any

155

Albania

any, telekom, vodafone

156

Uruguay

any, claro

157

Mauritius

any

158

Bhutan

any

159

Maldives

any

160

Guadeloupe

any

161

Turkmenistan

any

162

French Guiana

any

163

Finland

any, dna, elisa, telia

164

Saint Lucia

any

165

Luxembourg

any, tango, tiptop

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

173

Switzerland

any

174

Norway

any, lycamobile, my_call, telia

175

Australia

any, lebara, optus, telstra, vodafone

176

Eritrea

any

177

South Sudan

any, mtn, zain

178

Sao Tome and Principe

any

179

Aruba

any

180

Montserrat

any

181

Anguilla

any

183

Northern Macedonia

a1, any, lycamobile, telekom, vip

184

Republic of Seychelles

any

185

New Caledonia

any

186

Cape Verde

any

187

USA (Real)

any, at_t, joltmobile, lycamobile, moabits, tmobile

189

Fiji

any

196

Singapore

any, maxx, simba, singtel, starhub

Annex 2. Service list

№

Service code (ID)

Сountry name

Facebook

Instagram

Google,youtube,Gmail

Tinder

Twitter

Microsoft

Alipay/Alibaba

Amazon

Not on list

TikTok/Douyin

Vkontakte(vk.ru)

Apple

AOL

Naver

Grindr

Baidu

Discord

Yahoo

MTS CashBack (МТС Кешбек)

Lazada

Uber

WeChat

Nike

Магнит

PayPal

Line msg

Mail.ru (Майл.ру)

Банки

EBay

Shopee

Wildberries

Однокласники (ok.ru)

OLX

Signal

WinzoGame

Foodpanda

Viber

acz

Claude

Яндекс (Yandex)

99app

Pof.com

Olacabs

ChatGPT (openAI.com)

Pinduoduo

RedBook

Picpay

Grab

Gojek

Hinge

Yalla

Weibo

Eneba

Tokopedia

Fruitz

KakaoTalk

OkCupid

Zalo

MotorkuX

OVO

Mamba

Blizzard

Iti

Vinted

Mercado

Самокат

РСА

Dana

IFood

Indomaret

Happn

ada

TRUTH SOCIAL

Casino/bet/gambling

Bolt

MOMO

СберМаркет

Ticketmaster

Deliveroo

Avito

abt

ArenaPlus

GoogleVoice

agm

CMB

MyGLO

abu

BPJSTK

Leboncoin

AVON

OZON

TanTan

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

Airbnb

Careem

Лэтуаль

acp

BonusLink

BlaBlaCar

Steam

Sravni

GCash

als

Greggs

100

FreeNow

101

acy

Airtime

102

DiDi

103

Imo

104

Wise

105

Tencent QQ

106

Netflix

107

amn

Constitutioner

108

DoorDash

109

afc

Bunda

110

Bumble

111

Wolt

112

Snapchat

113

Alfagift

114

Wink

115

ShellBox

116

BLIBLI

117

adc

PlayOJO

118

Miravia

119

Zoho

120

JTExpress

121

BIGO LIVE

122

Rambler

123

ZéDelivery

124

Букмекерские (Betting)

125

Bet365

126

abq

Upwork

127

Lyft

128

Голос

129

Uklon

130

Xiaomi

131

NovaPoshta

132

Paxful

133

aeo

Allofresh

134

Payoneer

135

Santander

136

Oldubil

137

Юла

138

Temu

139

ЗдравСити

140

Depop

141

Carousell

142

Bilibili

143

Walmart

144

afd

Astra Otoshop

145

Meesho

146

Corona

147

MoneyPay

148

ahe

Bunq

149

Justdating

150

EscapeFromTarkov

151

Ашан

152

aiz

Brevo

153

adm

FitCredit

154

Kolesa.kz

155

afe

GovBr

156

aaa

Nubank

157

Akulaku

158

abc

Taptap Send

159

ВкусВилл

160

Paysafecard

161

Astropay

162

JDcom

163

abe

Foodora

164

Betfair

165

acm

Razer

166

BigC

167

Lenta

168

Hepsiburadacom

169

米画师Mihuashi

170

ahh

Cumbuca

171

akj

Easycash

172

Rediffmail

173

Truecaller

174

Ukrnet

175

EWallet

176

AdaKami

177

aav

Alchemy

178

aik

ZUS Coffee

179

Immowelt

180

X5ID

181

AptekaRU

182

Hopi

183

Prom

184

Metro

185

FunPay

186

Onet

187

Flipkart

188

abk

GMX

189

Delivery Club

190

Venmo

191

Burger King

192

Glovo

193

Badoo

194

Freelancer

195

Rozetka

196

aem

AstraPay

197

Şikayet var

198

Bazos

199

Idealista

200

ajt

Город

201

Fotka

202

Zolushka

203

СпортМастер

204

abg

PagBank

205

aff

C6 Bank

206

afs

Privalia

207

Cathay

208

acw

YouDo

209

SoulApp

210

Fiverr

211

Papara

212

agk

Ipsos iSay

213

Lotus

214

Familia

215

OfferUp

216

Coinbase

217

Myntra

218

Fora

219

ahi

Daki

220

ahl

Maxim

221

Urent/jet/RuSharing

222

AliExpress

223

Chispa

224

Twitch

225

alm

Muzz

226

Clubhouse

227

abo

WEBDE

228

alc

Facily

229

aca

Sunlight

230

Kwai

231

Beget

232

Craigslist

233

afq

MagaLu

234

amg

SBI Card

235

Airtel

236

afi

Ame Digital

237

MarketGuru

238

akz

Panvel

239

Hily

240

Kaggle

241

Yemeksepeti

242

OffGamers

243

afn

Roomster

244

alf

WEBULL

245

acj

Meituan

246

KFC

247

alj

Spotify

248

Revolut

249

RecargaPay

250

Drom

251

СберАптека

252

adi

Zepto

253

afz

Klarna

254

MPL

255

ala

GetResponse

256

Tango

257

Koshelek

258

aje

CupidMedia

259

ProtonMail

260

amb

Vercel

261

Ininal

262

Zhihu

263

Dream11

264

ahs

1and1

265

akt

Xworldwallet

266

Bukalapak

267

akc

Paybis

268

КухняНаРайоне

269