SMSPVA API Documentaion (1.0.

0)

Overview

The documentation for the SMSPVA.com website is organized into four key sections:

1. Main API Documentation for the Activation Section (Version 2)

2. Main API Documentation for the Rental Section (Version 1)
3. Alternative API Documentation for the Activation Section
4. Deprecated API Documentation for the Activation Section (Version 1)

Each API Section Includes:

Quick Start: Basic methods for getting started.

Data List: A list of services, countries, etc.
All Requests: A comprehensive list of requests with detailed explanations and examples.

ApiKey:

Your ApiKey is located in the Profile and ApiKey section, accessible via the top right drop-down menu.

Support:

For any issues, inquiries, or feedback, please contact technical support via the Help page or online
support chat.

Specific Instructions for the Activation API:

SMS Reception Timing: If you haven't received an SMS within 580 seconds (9 minutes and 40
seconds), make sure to ban the number you received. Attempting to ban the number after 10
minutes will result in the number not being banned and potentially being allocated again due to the
system retaining the request ID for 10 minutes before its deletion.
Connection rate limit: Up to 50 connections per seconds are allowed.
Query Interval: Maintain an interval of 4 to 5 seconds between any queries to ensure full API
utilization. Failure to adhere to this may lead to server rejection of your requests.
Quick start

Get Number
Get a number for country and service

AUTHORIZATIONS: apikey

PATH PARAMETERS

country string
required
Example: RU
Country 2 symbols name in ISO 3166-2 format, uppercase.
Countries list

service string
required
Example: opt20
Service code.
Services list

Responses

200

Successful operation

RESPONSE SCHEMA: application/json

statusCode integer
Example: "200"
Result status code

data object
Response data
 405

Invalid parameters

407

Your balance is too low to receive sms for selected country and service.

411

API access limited by low karma or ratelimits

500

Failed to fetch number

501

Number not found

502

Number not found.

503

Server overload, try later.

GET /activation/number/{country}/{service}

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url https://api.smspva.com/activation/number/RU/opt20 \
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200 405 407 411 500 501 502 503

Content type
application/json
 Copy Expand all Collapse all
{
"statusCode": 200,
- "data": {
"orderId": 123456,
"phoneNumber": 9876544321,
"countryCode": "RU",
"orderExpireIn": 600
}
}

Receive SMS
Receive SMS with service activation code

PATH PARAMETERS

orderid integer
required
Example: 123456
ID of order received in number response

HEADER PARAMETERS

partnerkey string
Example: 3eaa1c1f977d5a8152380f13cdfd03d0
Optional partnerkey parameter for referral system.

Responses

200

Successful operation

RESPONSE SCHEMA: application/json

statusCode integer
Example: "200"
Result status code
 data object
Response data

202

SMS not yet received

RESPONSE SCHEMA: application/json

statusCode integer
Example: "202"
Result status code

error object
Error data

405

Invalid parameters

406

Order ID format is invalid or not found

407

We received SMS but your balance is not enough to pay it.

410

This order is closed and unavailable

411

API access limited by low karma or ratelimits

500

Failed to fetch SMS.

501

Server failed to process request.

503

The server is overloaded and experiencing performance issues. Please try later.
 GET /activation/sms/{orderid}

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url https://api.smspva.com/activation/sms/123456 \
--header 'partnerkey: SOME_STRING_VALUE'

Response samples

200 202 405 406 407 410 411 500 501

503

Content type
application/json

Copy Expand all Collapse all

{
"statusCode": 200,
- "data": {
+ "sms": { … },
"orderId": "123456",
"orderExpireIn": 600
}
}

Data list

Countries list
For select the country you need - indicate according country code at the "country" parameter.

№ Flag Country Code

1 United States US

2 Canada CA

3 Unt. Kingdom UK

4 France FR

5 Germany DE

6 Italy IT

7 Spain ES

8 Albania AL

9 Argentina AR

10 Australia AU

11 Austria AT

12 Bangladesh BD

13 Bos. and Herz. BA

14 Brazil BR

15 Bulgaria BG

16 Cambodia KH

17 Cameroon CM
№ Flag Country Code

18 Chile CL

19 Colombia CO

20 Croatia HR

21 Cyprus CY

22 Czech Republic CZ

23 Denmark DK

24 Dominicana DO

25 Egypt EG

26 Estonia EE

27 Finland FI

28 Georgia GE

29 Ghana (Virtual) GH

30 Gibraltar GI

31 Greece GR

32 Hong Kong HK

33 Hungary HU

34 India IN

35 Japan JP

36 Kyrgyzstan (Virtual) KG
№ Flag Country Code

37 Malta MT

38 Norway NO

39 Pakistan (Virtual) PK

40 Saudi Arabia SA

41 Singapore SG

42 Switzerland CH

43 Tanzania TZ

44 Uzbekistan (Virtual) UZ

45 Indonesia ID

46 Ireland IE

47 Israel IL

48 Kazakhstan KZ

49 Kenya KE

50 Laos LA

51 Latvia LV

52 Lithuania LT

53 Macedonia MK

54 Malaysia MY

55 Mexico MX
№ Flag Country Code

56 Moldova MD

57 Morocco MA

58 Netherlands NL

59 New Zealand NZ

60 Nigeria NG

61 Paraguay PY

62 Philippines PH

63 Poland PL

64 Portugal PT

65 Romania RO

66 Russian Federation RU

67 Serbia RS

68 Slovakia SK

69 Slovenia SI

70 South Africa ZA

71 Sweden SE

72 Thailand TH

73 Turkey TR

74 Ukraine UA
 № Flag Country Code

75 Vietnam VN

Services list

If you do not find the service you need, then you can use the OTHER (opt19) service or contact support
to add the service you need.

№ Logo Service Code

1 1 OpenAI API (chatGPT, DALL-e 2) opt132

2 1cupis.ru opt251

3 22bet opt224

4 888casino opt22

5 Abbott opt242

6 Adidas & Nike opt86

7 Airbnb opt46

8 Alibaba (Taobao, 1688.com) opt61

9 Amazon opt44

10 AOL opt10

11 Apple opt131

12 autocosmos.com opt143

13 Avito opt59

14 Badoo opt56
№ Logo Service Code

15 BANDUS opt209

16 Bazos.sk opt138

17 Beget.com opt187

18 bet365 opt17

19 Betano (+BETANO.ro) opt192

20 BetFair opt25

21 Betmgm opt223

22 Bitpanda opt237

23 Blizzard opt78

24 blsspain-russia.com opt135

25 Bolt opt81

26 Brevo opt217

27 bumble opt145

28 bunq opt199

29 bwin opt137

30 Careem opt89

31 casa.it opt148

32 Cash App opt226

33 Cashrewards opt214

34 Casino Plus opt201

35 ChoTot opt176
№ Logo Service Code

36 CityMobil opt76

37 Claude (Anthropic) opt196

38 Clubhouse opt98

39 CoinBase opt112

40 CONTACT opt51

41 Craigslist opt26

42 Credit Karma opt124

43 CupidMedia opt157

44 Czech email services opt150

45 Deliveroo opt53

46 DenimApp opt204

47 DiDi opt92

48 Discord opt45

49 DistroKid opt232

50 Dodopizza + PapaJohns opt27

51 Doordash opt40

52 Drom.RU opt32

53 Drug Vokrug opt31

54 dundle opt136

55 EasyPay opt21

56 ENEBA opt200

57 ESX (abonamentesali.ro) opt248

№ Logo Service Code

58 EUROBET opt141

59 Facebook opt2

60 FastMail opt43

61 Fbet opt215

62 Feeld opt159

63 Fiverr opt6

64 fontbet opt139

65 foodora opt189

66 foodpanda opt115

67 Fortuna opt221

68 Fotostrana opt13

69 funpay opt142

70 G2A.COM opt68

71 Gameflip opt77

72 Gamers set (offgamers.com, G2A.com, seagm.com) opt28

73 GetsBet.ro opt179

74 GetTaxi opt35

75 GGbet opt188

76 GGPokerUK opt229

77 giocodigitale.it opt85

78 Glovo & Raketa opt108

79 goldbet.it opt240
№ Logo Service Code

80 Google (YouTube, Gmail) opt1

81 Google Voice opt140

82 GrabTaxi opt30

83 Grailed opt420

84 Grindr opt110

85 Happn opt155

86 HelloTalk opt203

87 hepsiburada opt238

88 Hey opt216

89 Hinge opt120

90 hopper opt144

91 HUAWEI opt166

92 ICard opt103

93 idealista.com opt165

94 ifood opt55

95 IMO opt111

96 inbox.lv opt167

97 Inboxdollars opt118

98 Instagram (+Threads) opt16

99 Ipsos opt193

100 IQOS opt243

№ Logo Service Code

101 JD.com opt94

102 KakaoTalk opt71

103 Klarna opt175

104 kleinanzeigen.de opt152

105 KoronaPay opt99

106 Kuper (SberMarket) opt97

107 kwiff.com opt129

108 Lajumate.ro opt195

109 Lalamove opt180

110 LAPOSTE opt182

111 LASVEGAS.RO opt222

112 Lazada opt60

113 Leboncoin opt164

114 Line Messenger opt37

115 LinkedIn opt8

116 Linode opt245

117 LiveScore opt42

118 LocalBitcoins opt105

119 Locanto.com opt114

120 Lyft opt75

№ Logo Service Code

121 Magnit opt126

122 Mail.RU opt33

123 Mail.ru Group opt4

124 Mamba opt100

125 Marktplaats opt171

126 Match opt250

127 maxline.by opt219

128 MiChat opt96

129 Microsoft (Azure, Bing, Skype, etc) opt15

130 mobileDE opt156

131 MOMO opt184

132 Monese opt121

133 MoneyLion opt47

134 MPSellers opt197

135 MrGreen opt211

136 MS Office 365 opt7

137 myopinions & erewards opt0

138 Naver opt73

139 Nectar opt198

140 NetBet opt95

141 Neteller opt116

№ Logo Service Code

142 Netflix opt101

143 NHNCloud opt202

144 NHNcorp (강남언니) opt177

145 Nico opt119

146 novibet.com opt151

147 OD opt5

148 OfferUp opt113

149 OkCupid opt230

150 OKX opt228

151 OLX + goods.ru opt70

152 onet.pl (Onet Konto) opt241

153 OTHER (no guarantee) opt19

154 OTHER (voice code) opt00019

155 OurTime opt212

156 Outlier opt246

157 OZON.ru opt181

158 Paddy Power opt109

159 Pari.ru opt169

160 Parimatch opt3

161 Payoneer opt162

162 PayPal + Ebay opt83

163 Paysafecard opt122

164 PAYSEND opt183

№ Logo Service Code

165 pm.by opt149

166 POF.com opt84

167 Prom.UA opt107

168 Proton Mail opt57

169 Publi24 opt207

170 Qiwi opt18

171 RadQuest opt247

172 Rambler.ru opt154

173 Revolut opt133

174 ROOMSTER opt153

175 Royal Canin opt170

176 RusDate opt186

177 Samokat opt185

178 Samsung opt174

179 Schibsted-konto opt134

180 Shopee opt48

181 Signal opt127

182 Sisal opt38

183 Skout opt49

184 Skrill opt117

185 Snapchat opt90

№ Logo Service Code

186 SNKRDUNK opt190

187 Solitaire Cash opt234

188 Steam opt58

189 subito.it opt146

190 Superbet opt249

191 Swagbucks opt125

192 Tango opt82

193 TANK.RU opt161

194 Taptap opt239

195 Taxi Maksim opt74

196 Telegram opt29

197 Telegram (voice code) opt00029

198 Tencent QQ opt34

199 Ticketmaster opt52

200 TikTok opt104

201 Tinder opt9

202 TLScontact opt235

203 TopCashback opt191

204 TOTOGAMING opt220

205 TransferGo opt218

206 TrueCaller opt233

207 Truth Social opt244

№ Logo Service Code

208 Twilio opt66

209 Twitch opt205

210 U By Prodia opt160

211 Uber opt72

212 Verse opt39

213 Viber opt11

214 Vinted opt130

215 VK (no guarantee) opt69

216 VonageVF opt178

217 VooV Meeting opt147

218 Waitomo opt213

219 WalletHub opt206

220 Walmart opt227

221 WEB.DE opt172

222 WebMoney&ENUM opt24

223 WeChat opt67

224 Weebly opt54

225 WESTSTEIN opt80

226 Whatnot opt231

227 WhatsAPP opt20

228 WhatsAPP (voice code) opt00020

 № Logo Service Code

229 Whoosh opt123

230 Wing Money opt106

231 Wise opt91

232 Wolt opt163

233 WooPlus opt208

234 X (Twitter) opt41

235 X World Wallet opt173

236 Yahoo opt65

237 Yalla.live opt88

238 Yandex&YooMoney opt23

239 Year13 opt236

240 Zalo opt158

241 Zasilkovna opt225

242 Zoho opt93

243 ZoomInfo opt194

All requests

Get Number
Get a number for country and service
AUTHORIZATIONS: apikey

PATH PARAMETERS

country string
required
Example: RU
Country 2 symbols name in ISO 3166-2 format, uppercase.
Countries list

service string
required
Example: opt20
Service code.
Services list

Responses

200

Successful operation

RESPONSE SCHEMA: application/json

statusCode integer
Example: "200"
Result status code

data object
Response data

405

Invalid parameters

407

Your balance is too low to receive sms for selected country and service.

411

API access limited by low karma or ratelimits

500

Failed to fetch number

 501

Number not found

502

Number not found.

503

Server overload, try later.

GET /activation/number/{country}/{service}

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url https://api.smspva.com/activation/number/RU/opt20 \
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200 405 407 411 500 501 502 503

Content type
application/json

Copy Expand all Collapse all

{
"statusCode": 200,
- "data": {
"orderId": 123456,
"phoneNumber": 9876544321,
"countryCode": "RU",
"orderExpireIn": 600
}
}
Receive SMS
Receive SMS with service activation code

PATH PARAMETERS

orderid integer
required
Example: 123456
ID of order received in number response

HEADER PARAMETERS

partnerkey string
Example: 3eaa1c1f977d5a8152380f13cdfd03d0
Optional partnerkey parameter for referral system.

Responses

200

Successful operation

RESPONSE SCHEMA: application/json

statusCode integer
Example: "200"
Result status code

data object
Response data

202

SMS not yet received

RESPONSE SCHEMA: application/json

statusCode integer
Example: "202"
Result status code
 error object
Error data

405

Invalid parameters

406

Order ID format is invalid or not found

407

We received SMS but your balance is not enough to pay it.

410

This order is closed and unavailable

411

API access limited by low karma or ratelimits

500

Failed to fetch SMS.

501

Server failed to process request.

503

The server is overloaded and experiencing performance issues. Please try later.

GET /activation/sms/{orderid}

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url https://api.smspva.com/activation/sms/123456 \
--header 'partnerkey: SOME_STRING_VALUE'
Response samples

200 202 405 406 407 410 411 500 501

503

Content type
application/json

Copy Expand all Collapse all

{
"statusCode": 200,
- "data": {
+ "sms": { … },
"orderId": "123456",
"orderExpireIn": 600
}
}

Get user's balance

Get user's balance

AUTHORIZATIONS: apikey

Responses

200

Successful operation

RESPONSE SCHEMA: application/json

statusCode integer
Example: "200"
Result status code
 data object
Response data

GET /activation/balance

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url https://api.smspva.com/activation/balance \
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"statusCode": 200,
- "data": {
"balance": 10.5
}
}

Get user's info

Get user's info

AUTHORIZATIONS: apikey
Responses

200

Successful operation

RESPONSE SCHEMA: application/json

statusCode integer
Example: "200"
Result status code

data object
Response data

GET /activation/userinfo

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url https://api.smspva.com/activation/userinfo \
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"statusCode": 200,
- "data": {
"balance": 10.5,
"name": "user123",
"karma": 100.5
}
 }

Get available numbers count for each country and mobile

operator
Get available numbers count for each country and mobile operator

AUTHORIZATIONS: apikey

PATH PARAMETERS

country string
Example: RU
Country 2 symbols name in ISO 3166-2 format, uppercase.
Countries list

Responses

200

Successful operation

RESPONSE SCHEMA: application/json

statusCode integer
Example: "200"
Result status code

data Array of objects [ items ]

Response data

GET /activation/countnumbers/{country}

Request samples
 Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url https://api.smspva.com/activation/countnumbers/RU \
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"statusCode": 200,
- "data": [
+ [ … ]
]
}

Get service price specific country

Get service price specific country

AUTHORIZATIONS: apikey

PATH PARAMETERS

country string
required
Example: RU
Country 2 symbols name in ISO 3166-2 format, uppercase.
Countries list

service string
required
Example: opt0
Service code.
Services list
Responses

200

Successful operation

RESPONSE SCHEMA: application/json

statusCode integer
Example: "200"
Result status code

data object
Response data

GET /activation/serviceprice/{country}/{service}

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url https://api.smspva.com/activation/serviceprice/RU/opt0 \
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"statusCode": 200,
- "data": {
"service": "opt0",
"serviceDescription": "myopinions & erewards",
"price": 0.5
}
 }

Get prices for all services

Get prices for all services

AUTHORIZATIONS: apikey

Responses

200

Successful operation

RESPONSE SCHEMA: application/json

statusCode integer
Example: "200"
Result status code

data Array of objects [ items ]

Response data

GET /activation/servicesprices

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url https://api.smspva.com/activation/servicesprices \
--header 'apikey: REPLACE_KEY_VALUE'

Response samples
 200

Content type
application/json

Copy Expand all Collapse all

{
"statusCode": 200,
- "data": [
+ [ … ]
]
}

Check if number is still able to receive SMS for certain

service
Check if number is still able to receive SMS for certain service. Only if you used to receive SMS on this
number for this service previously.

AUTHORIZATIONS: apikey

PATH PARAMETERS

number integer
required
Example: 98765432
Phone number without country phone code.

service string
required
Example: opt0
Service code. To see all service codes please refer to servicesprices method.

Responses

200

Successful operation

RESPONSE SCHEMA: application/json

 statusCode integer
Example: "200"
Result status code

data object
Response data

405

Invalid number format

GET /activation/numberstatus/{number}/{service}

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url https://api.smspva.com/activation/numberstatus/98765432/opt0 \
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200 405

Content type
application/json

Copy Expand all Collapse all

{
"statusCode": 200,
- "data": {
"number": 98765432,
"orderId": 123456
}
}
Delete current SMS to receive new one.
Delete current SMS to receive new one.

AUTHORIZATIONS: apikey

PATH PARAMETERS

orderid integer
required
Example: 123456
Order ID

Responses

200

Successful operation

RESPONSE SCHEMA: application/json

statusCode integer
Example: "200"
Result status code

data object
Response data

404

No SMS received, or there's unpaid SMS waiting.

405

Invalid parameters

406

Order not found.

501

Server failed to process request.

 503

No SMS received, or there's unpaid SMS waiting.

PUT /activation/clearsms/{orderid}

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request PUT \
--url https://api.smspva.com/activation/clearsms/123456 \
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200 404 405 406 501 503

Content type
application/json

Copy Expand all Collapse all

{
"statusCode": 200,
- "data": {
"orderId": 123456,
"orderExpireIn": 599
}
}

Cancel order.
Cancel order.

AUTHORIZATIONS: apikey

PATH PARAMETERS
 orderid integer
required
Example: 123456
Order ID

Responses

200

Successful operation

RESPONSE SCHEMA: application/json

statusCode integer
Example: "200"
Result status code

data object
Response data

405

Invalid parameters

406

Order ID format is invalid or not found

411

API access limited by low karma or ratelimits

501

Server failed to process request.

503

The server is overloaded and experiencing performance issues. Please try later.

PUT /activation/cancelorder/{orderid}

Request samples
 Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request PUT \
--url https://api.smspva.com/activation/cancelorder/123456 \
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200 405 406 411 501 503

Content type
application/json

Copy Expand all Collapse all

{
"statusCode": 200,
- "data": {
"orderId": 123456
}
}

Set number as nonworking.

Set number as nonworking.

AUTHORIZATIONS: apikey

PATH PARAMETERS

orderid integer
required
Example: 123456
Order ID

Responses

200

Successful operation
 RESPONSE SCHEMA: application/json

statusCode integer
Example: "200"
Result status code

data object
Response data

405

Invalid number format

406

Order ID format is invalid or not found

411

API access limited by low karma or ratelimits

501

Server failed to process request.

503

The server is overloaded and experiencing performance issues. Please try later.

PUT /activation/blocknumber/{orderid}

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request PUT \
--url https://api.smspva.com/activation/blocknumber/123456 \
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200 405 406 411 501 503

 Content type
application/json

Copy Expand all Collapse all

{
"statusCode": 200,
- "data": {
"orderId": 123456
}
}

Get current orders.

Get current orders.

AUTHORIZATIONS: apikey

Responses

200

Successful operation

RESPONSE SCHEMA: application/json

statusCode integer
Example: "200"
Result status code

data object
Response data

501

Server failed to process request.

 503

The server is overloaded and experiencing performance issues. Please try later.

GET /activation/orders

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url https://api.smspva.com/activation/orders \
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200 501 503

Content type
application/json

Copy Expand all Collapse all

{
"statusCode": 200,
- "data": {
+ "orders": [ … ]
}
}

Quick start

Creating new order

Rent a number

QUERY PARAMETERS

method string
required
Example: method=create
Method name

apikey string
required
Example: apikey=yourapikeyhere
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

dtype string
required
Example: dtype=week
Type of period: week or month

dcount integer
required
Example: dcount=1
Count type of period, i.e. if dtype=week then counts of weeks

country string
required
Example: country=RU
Country code of number
Countries list

service string
required
Example: service=opt6
Service code
Services list

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Example: "1"
Status of the response: 1 for success, 0 for failure
 data Array of objects

GET /api/rent.php?method=create

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=create&apikey=yourapikeyhere&

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"status": 1,
- "data": [
+ { … }
]
}

Сreating order with multiple services

Rent a number

QUERY PARAMETERS
 method string
required
Example: method=create_multi
Method name

apikey string
required
Example: apikey=yourapikeyhere
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

dtype string
required
Example: dtype=week
Type of period: week or month

dcount integer
required
Example: dcount=1
Count type of period, i.e. if dtype=week then counts of weeks

country string
required
Example: country=RU
Country code of number
Countries list

services string
required
Example: services=opt6,opt7,opt8
Services codes separated by commas
Services list

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Example: "1"
Status of the response: 1 for success, 0 for failure

data Array of objects

 GET /api/rent.php?method=create_multi

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=create_multi&apikey=yourapike

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"status": 1,
- "data": [
+ { … }
]
}

Activation phone number

Before sending an SMS, you must activate the number.

QUERY PARAMETERS

method string
required
Example: method=activate
Method name

apikey string
required
Example: apikey=yourapikeyhere
 Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

id integer
required
Example: id=1
ID of order

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Example: "1"
Status of the response: 1 for success, 0 for failure

data Array of objects

GET /api/rent.php?method=activate

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=activate&apikey=yourapikeyher

Response samples

200

Content type
application/json
 Copy Expand all Collapse all
{
"status": "1",
- "data": [
+ { … }
]
}

Getting list of orders

Check the readiness to receive sms of the desired number

QUERY PARAMETERS

method string
required
Example: method=orders
Method name

apikey string
required
Example: apikey=yourapikeyhere
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Example: "1"
Status of the response: 1 for success, 0 for failure

data Array of objects

 GET /api/rent.php?method=orders

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=orders&apikey=yourapikeyhere'

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"status": 1,
- "data": [
+ { … }
]
}

Getting all SMS of order

Get SMS of number

QUERY PARAMETERS

method string
required
Example: method=sms
Method name

apikey string
required
Example: apikey=yourapikeyhere
 Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

id integer
required
Example: id=123
ID of order

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Status of the response: 1 for success, 0 for failure

data Array of objects

GET /api/rent.php?method=sms

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=sms&apikey=yourapikeyhere&id=

Response samples

200

Content type
application/json
 Copy Expand all Collapse all
{
"status": 0,
- "data": [
+ { … }
]
}

Data list

Countries list

For select the country you need - indicate according country code at the "country" parameter.

№ Flag Country Code

1 Puerto Rico PR

2 United States US

3 Canada CA

4 Unt. Kingdom UK

5 France FR

6 Germany DE

7 Italy IT

8 Spain ES
№ Flag Country Code

9 Albania AL

10 Argentina AR

11 Australia AU

12 Austria AT

13 Bangladesh BD

14 Bulgaria BG

15 Cambodia KH

16 Croatia HR

17 Cyprus CY

18 Czech Republic CZ

19 Denmark DK

20 Egypt EG

21 Estonia EE

22 Finland FI

23 Greece GR

24 Hong Kong HK

25 Hungary HU

26 Japan JP

27 Malta MT
№ Flag Country Code

28 Norway NO

29 Switzerland CH

30 Tanzania TZ

31 Indonesia ID

32 Ireland IE

33 Israel IL

34 Kazakhstan KZ

35 Latvia LV

36 Lithuania LT

37 Macedonia MK

38 Malaysia MY

39 Mexico MX

40 Moldova MD

41 Netherlands NL

42 New Zealand NZ

43 Paraguay PY

44 Philippines PH

45 Poland PL

46 Portugal PT
 № Flag Country Code

47 Romania RO

48 Russian Federation RU

49 Serbia RS

50 Slovakia SK

51 Slovenia SI

52 Sweden SE

53 Thailand TH

54 Turkey TR

55 Ukraine UA

Services list

If you do not find the service you need, then you can use the OTHER (opt19) service or contact support
to add the service you need.

№ Logo Service Code

1 1cupis & okcupid & winline opt48

2 1xbet opt77

3 Airbnb (VRBO.com, HomeAway) opt46

4 airtm opt204

5 airwallex.com opt161

6 Alibaba Group (TaoBao, AliPay, etc) opt61

№ Logo Service Code

7 Amazon opt44

8 Apple opt154

9 Ari10 opt206

10 astropay.com opt102

11 Avito opt59

12 B100 opt215

13 bankera.com opt45

14 Batery.in (baterybet) opt184

15 Bazos.sk opt193

16 BBVA opt141

17 bet365 opt43

18 Betano opt210

19 betwinner3.com opt51

20 Bilderlings opt177

21 Binance opt10

22 bit2me opt203

23 Bitnovo opt207

24 Bitpanda opt199

25 BITSA opt57

26 Bitwala opt94

27 blackcatcard opt144

28 Blizzard(+battle.net) opt3
№ Logo Service Code

29 bluevine opt49

30 Bnext opt25

31 booking opt88

32 Bovada opt214

33 Brighty.app opt213

34 Bumble.com opt165

35 BUNQ opt21

36 casa.it opt98

37 Chase opt40

38 CoinBase opt70

39 CONTACT opt164

40 Crypto.com opt56

41 Discord opt147

42 DPD UK opt221

43 dukascopy opt91

44 Dzing opt71

45 Esselunga opt194

46 EUROBET opt68

47 Facebook opt2

48 Fbet opt171

49 Finom opt179
№ Logo Service Code

50 Fiverr opt6

51 Flowbank opt181

52 fonbet opt158

53 Foxpay opt190

54 gemini.com opt54

55 Google (GMail, YTube, etc.) opt1

56 Green Dot opt220

57 Guavapay(+Myguava) opt152

58 Hinge opt185

59 Holvi opt80

60 huobi.com opt150

61 hype.it opt105

62 iCard opt99

63 imagin opt89

64 Indeed.com opt34

65 ing (.es, .it, etc) opt174

66 Instagram (+Threads) opt16

67 JD.com opt198

68 Joust2trade opt92

69 KCEX opt201

70 Klarna opt156

71 Kleinanzeigen opt178
№ Logo Service Code

72 Kraken opt81

73 kucoin/bybit opt166

74 Leboncoin opt216

75 libero.it opt187

76 LINE opt32

77 LinkedIn opt8

78 Lottomatica.it (Better, Goldbet, Betflag) opt175

79 Lydia(+Sumeria) opt167

80 Mail.RU (VK, OK, Youla) opt33

81 Mail.ru Group opt4

82 match.com opt96

83 Microsoft (Azure, Bing, HotMail, etc.) opt15

84 Monese opt97

85 moneygram.com opt35

86 Moneyjar opt140

87 MoneyLion opt75

88 Moneytopay opt162

89 mooneygroup.it opt183

90 Mostbet opt143

91 MyBookie opt191

92 myfin.bg opt168

93 N26 opt52
№ Logo Service Code

94 NamirialTSP opt186

95 NCSOFT opt211

96 Neteller opt1001

97 nexo.io opt26

98 nickel.eu opt189

99 Noelse opt197

100 northone.com opt30

101 okx.com opt95

102 openbank.es opt13

103 opinionoutpost opt28

104 OTHER opt142

105 ourtime.com opt27

106 Outlier opt217

107 OZON.ru opt148

108 Paxful (Noone) opt72

109 Payoneer opt103

110 PayPal + Ebay opt83

111 Paysafecard (+Mojeplatnosci) opt90

112 PaySend opt38

113 Paysera opt172

114 paytend opt159

115 Payz opt205

№ Logo Service Code

116 Payzy opt195

117 Payzy opt196

118 pecunpay opt202

119 Phyre opt93

120 plazo.es opt145

121 pockit opt157

122 POF opt84

123 Pointsbet&Betmgm&Chime&Schwab opt37

124 Pyypl opt42

125 Qiwi opt18

126 Qonto opt170

127 Rebellion opt73

128 Rebet.com opt218

129 RedotPay opt208

130 relayfi.com opt53

131 Revolut opt101

132 REWARDCARD opt219

133 riamoneytransfer opt60

134 shine.fr opt176

135 Signal opt153

136 sisal opt155

137 Skrill opt74

№ Logo Service Code

138 Steam opt58

139 SumUp opt182

140 Swagbucks opt173

141 swissmoney opt188

142 Taptap opt212

143 Telegram opt29

144 Tic Life opt209

145 Ticketmaster opt146

146 TikTok opt104

147 Tinder opt9

148 Transfego opt180

149 trastra.com opt160

150 Twilio & eToro opt66

151 ValuedOpinions opt39

152 Venmo opt85

153 Verse opt17

154 VFS Global application opt200

155 Viber opt11

156 Vinted opt31

157 Vivastreet opt67

158 Vivid opt100

 № Logo Service Code

159 Volet(Advcash) opt78

160 VRBO.com opt169

161 wallester.com opt149

162 Walmart opt192

163 WebMoney&ENUM opt24

164 westernunion opt82

165 Weststein(MasterCard) opt76

166 WhatsAPP opt20

167 Willhaben opt163

168 Wirex opt7

169 Wise (TransferWise) opt0

170 X (Twitter) opt41

171 Yahoo opt65

172 Yandex&YooMoney opt23

173 zen opt151

All requests

Creating new order

Rent a number

QUERY PARAMETERS

method string
required
Example: method=create
Method name

apikey string
required
Example: apikey=yourapikeyhere
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

dtype string
required
Example: dtype=week
Type of period: week or month

dcount integer
required
Example: dcount=1
Count type of period, i.e. if dtype=week then counts of weeks

country string
required
Example: country=RU
Country code of number
Countries list

service string
required
Example: service=opt6
Service code
Services list

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Example: "1"
Status of the response: 1 for success, 0 for failure
 data Array of objects

GET /api/rent.php?method=create

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=create&apikey=yourapikeyhere&

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"status": 1,
- "data": [
+ { … }
]
}

Сreating order with multiple services

Rent a number

QUERY PARAMETERS
 method string
required
Example: method=create_multi
Method name

apikey string
required
Example: apikey=yourapikeyhere
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

dtype string
required
Example: dtype=week
Type of period: week or month

dcount integer
required
Example: dcount=1
Count type of period, i.e. if dtype=week then counts of weeks

country string
required
Example: country=RU
Country code of number
Countries list

services string
required
Example: services=opt6,opt7,opt8
Services codes separated by commas
Services list

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Example: "1"
Status of the response: 1 for success, 0 for failure

data Array of objects

 GET /api/rent.php?method=create_multi

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=create_multi&apikey=yourapike

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"status": 1,
- "data": [
+ { … }
]
}

Activation phone number

Before sending an SMS, you must activate the number.

QUERY PARAMETERS

method string
required
Example: method=activate
Method name

apikey string
required
Example: apikey=yourapikeyhere
 Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

id integer
required
Example: id=1
ID of order

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Example: "1"
Status of the response: 1 for success, 0 for failure

data Array of objects

GET /api/rent.php?method=activate

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=activate&apikey=yourapikeyher

Response samples

200

Content type
application/json
 Copy Expand all Collapse all
{
"status": "1",
- "data": [
+ { … }
]
}

Getting list of orders

Check the readiness to receive sms of the desired number

QUERY PARAMETERS

method string
required
Example: method=orders
Method name

apikey string
required
Example: apikey=yourapikeyhere
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Example: "1"
Status of the response: 1 for success, 0 for failure

data Array of objects

 GET /api/rent.php?method=orders

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=orders&apikey=yourapikeyhere'

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"status": 1,
- "data": [
+ { … }
]
}

Getting all SMS of order

Get SMS of number

QUERY PARAMETERS

method string
required
Example: method=sms
Method name

apikey string
required
Example: apikey=yourapikeyhere
 Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

id integer
required
Example: id=123
ID of order

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Status of the response: 1 for success, 0 for failure

data Array of objects

GET /api/rent.php?method=sms

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=sms&apikey=yourapikeyhere&id=

Response samples

200

Content type
application/json
 Copy Expand all Collapse all
{
"status": 0,
- "data": [
+ { … }
]
}

Getting available countries list

Get available countries list

QUERY PARAMETERS

method string
required
Example: method=getcountries
Method name

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer

data Array of objects

GET /api/rent.php?method=getcountries

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

 Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=getcountries'

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"status": 0,
- "data": [
+ { … }
]
}

Getting available services list

Get a list of available services

QUERY PARAMETERS

method string
required
Example: method=getdata
Method name

apikey string
required
Example: apikey=yourapikeyhere
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

country string
required
Example: country=RU
Country code of number
Countries list

dtype string
required
Example: dtype=week
 Type of period: week or month

dcount integer
required
Example: dcount=1
Count type of period, i.e. if dtype=week then counts of weeks

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Status of the response: 1 for success, 0 for failure

data Array of objects

GET /api/rent.php?method=getdata

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=getdata&apikey=yourapikeyhere

Response samples

200

Content type
application/json

Copy Expand all Collapse all

 {
"status": 0,
- "data": [
+ { … }
]
}

Adding new service for existing order

Add another service to order

QUERY PARAMETERS

method string
required
Example: method=add_service_to_order
Method name

apikey string
required
Example: apikey=yourapikeyhere
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

id integer
required
Example: id=56547
ID of order

service string
required
Example: service=opt89
Service code
Services list

pnumber string
required
Example: pnumber=79335445295
rented phone number with country code without plus sign

Responses

200

Success
 RESPONSE SCHEMA: application/json

status integer
Example: "1"
Status of the response: 1 for success, 0 for failure

GET /api/rent.php?method=add_service_to_order

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=add_service_to_order&apikey=y

Response samples

200

Content type
application/json

Copy
{
"status": 1
}

Prolongation order
Prolongation

QUERY PARAMETERS

method string
required
 Example: method=prolong
Method name

apikey string
required
Example: apikey=yourapikeyhere
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

id integer
required
Example: id=123
ID of order

dtype string
required
Example: dtype=week
Type of period: week or month

dcount integer
required
Example: dcount=1
Count type of period, i.e. if dtype=week then counts of weeks

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Status of the response: 1 for success, 0 for failure

data object

GET /api/rent.php?method=prolong

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

 Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=prolong&apikey=yourapikeyhere

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"status": 0,
- "data": {
"id": "123"
}
}

Removing order
Removing

QUERY PARAMETERS

method string
required
Example: method=delete
Method name

apikey string
required
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

id integer
ID of order

Responses
 200

Success

RESPONSE SCHEMA: application/json

status integer
Example: "1"
Status of the response: 1 for success, 0 for failure

data object

GET /api/rent.php?method=delete

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=delete&apikey=SOME_STRING_VAL

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"status": 1,
- "data": {
"id": 123
}
}
Getting history of rental
To restore the lease agreement, you need to get the order ID. To get a list of orders with the necessary
information from the archive, you can request

QUERY PARAMETERS

method string
required
Example: method=get_rent_history
Method name

apikey string
required
Example: apikey=yourapikeyhere
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

skip integer
Example: skip=0
Number of items to skip

take integer
Example: take=10
Number of items received

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Example: "1"
Status of the response: 1 for success, 0 for failure

data Array of objects

 GET /api/rent.php?method=get_rent_history

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=get_rent_history&apikey=youra

Response samples

200

Content type
application/json

Copy Expand all Collapse all

{
"status": 1,
- "data": [
+ { … }
]
}

Precalcution of restoring
After receiving the ID of the desired reservation, you need to make another request to check the
availability of the for rent`s and calculate the cost of restoration.

QUERY PARAMETERS

method string
required
Example: method=restore_user_precalc
Method name

apikey string
required
 Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

id integer
ID of order

Responses

200

Success

RESPONSE SCHEMA: application/json

status integer
Status of the response: 1 for success, 0 for failure

data object

GET /api/rent.php?method=restore_user_precalc

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=restore_user_precalc&apikey=S

Response samples

200

Content type
application/json

Copy Expand all Collapse all

 {
"status": 0,
- "data": {
"ccode": "EN",
"scode": "opt59",
"price": 2.4,
"sname": "Avito",
"pnumber": "79929831844",
"outdays": 32,
"orderid": 317017,
"prolongTo": 30
}
}

Restoring of outdated order

If an exception occurs, we will receive a status with the value 0 and an error message in the msg field.
at the bottom of the instructions is a list of possible exceptions and their description
After receiving a positive response and agreeing to the terms of the lease restoration, you can make a
last request that will return the rental number
The request will return an object with status and data fields, if the values are positive, then the number
has been restored. If the values are not positive, double-check the data and try again, if this also did not
help, contact the site support service

QUERY PARAMETERS

method string
required
Example: method=restore_user
Method name

apikey string
required
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

id integer
ID of order

Responses
 200

Success

RESPONSE SCHEMA: application/json

status integer
Example: "1"
Status of the response: 1 for success, 0 for failure

data boolean
Example: "true"
Boolean indicating if the number has been restored

GET /api/rent.php?method=restore_user

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/api/rent.php?method=restore_user&apikey=SOME_STRI

Response samples

200

Content type
application/json

Copy
{
"status": 1,
"data": true
}
Quick start

Getting phone number

Getting phone number

QUERY PARAMETERS

action string
required
Example: action=getnumber

api_key string
required
Example: api_key=yourapikeyhere

country string
required
Example: country=0
Country code
Countries list

service string
required
Example: service=go
Service code
Services list

operator string
Example: operator=MTS_RU

Responses

200

Successfully response

RESPONSE SCHEMA: text/plain

One of Phone number received No available phone numbers

string (Phone number received)

 ACCESS_NUMBER:ORDERID:PHONENUMBER

GET /stubs/handler_api.php?action=getNumber

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/stubs/handler_api.php?action=getNumber&api_key=yo

Getting SMS
Getting SMS

QUERY PARAMETERS

action string
required
Example: action=getstatus
Action type

api_key string
required
Example: api_key=yourapikeyhere
User's APIKEY

id string
required
Example: id=123
Order id

Responses

200

Successfully response
 RESPONSE SCHEMA: text/plain

One of Success. SMS received Error. Bad apikey Error. Order not found or ID exists

string (Success. SMS received)

STATUS_OK:SMS TEXT HERE

GET /stubs/handler_api.php?action=getstatus

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/stubs/handler_api.php?action=getstatus&api_key=yo

Data list

Countries list

Alternative's code SMSPVA's code

0 RU

1 UA

2 KZ

3 CN2
Alternative's code SMSPVA's code

4 PH

5 GE

6 ID

7 BY

8 KE

10 VN

11 KG

12 US

13 IL

14 PY

15 PL

16 UK

17 US3

18 FI

20 MO

21 EG

22 IN

23 IE

24 KH

26 HT

27 CI

28 GM

29 RS

30 YE

31 ZA

32 RO

33 SE

34 EE

38 GH
 Alternative's code SMSPVA's code

39 AR

42 TD

43 DE

44 LT

48 NL

49 LV

51 BY

56 ES

63 CZ

67 NZ

68 GN

69 ML

73 BR

117 PT

78 FR

172 DK

85 MD

86 CO

Services list

Alternative's code SMSPVA's code

vk opt69

mg opt4

ok opt5

wa opt20

vi opt11
Alternative's code SMSPVA's code

tg opt29

wb opt67

go opt1

av opt59

fb opt2

tw opt41

ot opt19

ub opt72

qw opt18

gt opt35

sn opt70

ig opt16

ym opt14

ma opt33

mm opt15

uk opt46

me opt37

mb opt65

we opt31

bd opt102

kp opt47

ya opt23

mt opt58

oi opt9

fd opt17

zz opt99

kt opt71

pm opt10

tn opt8
 Alternative's code SMSPVA's code

tiktok opt104

mi opt106

mts opt48

rsa opt111

magnit opt106

ry opt118

yf opt76

re opt112

ab opt61

am opt44

tx opt81

pd opt55

dp opt57

hz opt32

kc opt130

qj opt123

xj opt97

All requests

Getting phone number

Getting phone number

QUERY PARAMETERS

action string
required
Example: action=getnumber

api_key string
 required
Example: api_key=yourapikeyhere

country string
required
Example: country=0
Country code
Countries list

service string
required
Example: service=go
Service code
Services list

operator string
Example: operator=MTS_RU

Responses

200

Successfully response

RESPONSE SCHEMA: text/plain

One of Phone number received No available phone numbers

string (Phone number received)

ACCESS_NUMBER:ORDERID:PHONENUMBER

GET /stubs/handler_api.php?action=getNumber

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/stubs/handler_api.php?action=getNumber&api_key=yo
Getting user's balance
Getting user's balance

QUERY PARAMETERS

action string
required
Example: action=getbalance

api_key string
required
Example: api_key=yourapikeyhere

Responses

200

Successfully response

RESPONSE SCHEMA: text/plain

One of Success Error. Bad apikey

string (Success)
ACCESS_BALANCE:BALANCE VALUE HERE

GET /stubs/handler_api.php?action=getbalance

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/stubs/handler_api.php?action=getbalance&api_key=y
Close order
Close order

QUERY PARAMETERS

action string
required
Example: action=setstatus

api_key string
required
Example: api_key=yourapikeyhere

status string
required
Example: status=-1
Status which need to set

id string
required
Example: id=123
Order ID

Responses

200

Successfully response

RESPONSE SCHEMA: text/plain

One of Order successfully cancelled Error. Bad apikey

string (Order successfully cancelled)

ACCESS_CANCEL

GET /stubs/handler_api.php?action=setstatus&status=8

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

 Copy
curl --request GET \
--url 'https://smspva.com/stubs/handler_api.php?action=setstatus&api_key=yo

Cancel order
Cancel order

QUERY PARAMETERS

action string
required
Example: action=setstatus

api_key string
required
Example: api_key=yourapikeyhere

status string
required
Example: status=-1
Status which need to set

id string
required
Example: id=123
Order ID

Responses

200

Successfully response

RESPONSE SCHEMA: text/plain

One of Order successfully cancelled Error. Bad apikey

string (Order successfully cancelled)

ACCESS_CANCEL
 GET /stubs/handler_api.php?action=setstatus&status=-1

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/stubs/handler_api.php?action=setstatus&api_key=yo

Closing order
Closing order

QUERY PARAMETERS

action string
required
Example: action=setstatus
Action type

api_key string
required
Example: api_key=yourapikeyhere
User's APIKEY

id string
required
Example: id=123
Order id

Responses

200

Successfully response

RESPONSE SCHEMA: text/plain

One of Success. SMS received Error. Bad apikey Error. Order not found or ID exists
 string (Success. SMS received)
STATUS_OK:SMS TEXT HERE

GET /stubs/handler_api.php?action=setstatus&status=6

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/stubs/handler_api.php?action=setstatus&api_key=yo

Getting SMS
Getting SMS

QUERY PARAMETERS

action string
required
Example: action=getstatus
Action type

api_key string
required
Example: api_key=yourapikeyhere
User's APIKEY

id string
required
Example: id=123
Order id

Responses

200

Successfully response
 RESPONSE SCHEMA: text/plain

One of Success. SMS received Error. Bad apikey Error. Order not found or ID exists

string (Success. SMS received)

STATUS_OK:SMS TEXT HERE

GET /stubs/handler_api.php?action=getstatus

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/stubs/handler_api.php?action=getstatus&api_key=yo

Errors

BAD_ACTION - Incorrect action parameter

ERROR_SQL - Technical error on server
BAD_KEY - Incorrect APIKEY parameter
NO_ACTIVATION - Order not found or expired
BAD_STATUS - Incorrect status parameter

Quick start

Getting phone number

Request for receiving a phone number for a certain service

AUTHORIZATIONS: apikey

QUERY PARAMETERS

apikey string
required
Example: apikey=DSWAFvdedrE4
Your API key

service string
required
Example: service=opt4
Service code

country string
required
Example: country=RU
Country code

metod string
required
Example: metod=get_number
Method name

Responses

200

Success

RESPONSE SCHEMA: application/json

response string
Example: "2"
Status

number string
Example: "9871234567"
Number to receive SMS

id string
Example: "25623"
Order ID
 GET /priemnik.php?method=get_number

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/priemnik.php?apikey=DSWAFvdedrE4&service=opt4&cou
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy
{
"response": "2",
"number": "9871234567",
"id": "25623"
}

Getting SMS
Receiving an SMS for a certain service
In this method id parameter is indicated from the response to request for phone number get_number

Note

If you get the response that a code from SMS hasn't been found yet, send request get_sms once
again 20 seconds later. Note, the server searches for SMS for 10 minutes. You need to send your
request within 10 minutes each 20 seconds per one request. That said, you receive a code from
SMS or error message.

Code Refinement
If you want to get re-SMS without closing the order (Code Refinement), then just on the method
get_sms add additional parameter sms=sms Example string:

https://smspva.com/priemnik.php?
metod=get_sms
&country=ru
&service=opt4
&id=25623
&apikey=DSWAFvdedrE4
&sms=sms

In this case, your order can not be closed and you may receive a re-SMS. Re-chargeable SMS. The cost
is the cost of an ordinary SMS for this service.

AUTHORIZATIONS: apikey

QUERY PARAMETERS

apikey string
required
Example: apikey=DSWAFvdedrE4
Your API key

service string
required
Example: service=opt4
Service code

country string
required
Example: country=RU
Country code

id string
required
Example: id=3421
ID of the order

metod string
required
Example: metod=get_sms
Method name

Responses

200

Success

RESPONSE SCHEMA: application/json

 response string
Example: "2"
Status

number string
Example: "9871234567"
Number to receive SMS

sms string
Example: "234562"
Code from SMS

GET /priemnik.php?method=get_sms

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/priemnik.php?apikey=DSWAFvdedrE4&service=opt4&cou
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy
{
"response": 2,
"number": "9871234567",
"sms": "234562"
}
Data list

Countries list

For select the country you need - indicate according country code at the "country" parameter.

№ Flag Country Code

1 United States US

2 Canada CA

3 Unt. Kingdom UK

4 France FR

5 Germany DE

6 Italy IT

7 Spain ES

8 Albania AL

9 Argentina AR

10 Australia AU

11 Austria AT

12 Bangladesh BD
№ Flag Country Code

13 Bos. and Herz. BA

14 Brazil BR

15 Bulgaria BG

16 Cambodia KH

17 Cameroon CM

18 Chile CL

19 Colombia CO

20 Croatia HR

21 Cyprus CY

22 Czech Republic CZ

23 Denmark DK

24 Dominicana DO

25 Egypt EG

26 Estonia EE

27 Finland FI

28 Georgia GE

29 Ghana (Virtual) GH

30 Gibraltar GI

31 Greece GR
№ Flag Country Code

32 Hong Kong HK

33 Hungary HU

34 India IN

35 Japan JP

36 Kyrgyzstan (Virtual) KG

37 Malta MT

38 Norway NO

39 Pakistan (Virtual) PK

40 Saudi Arabia SA

41 Singapore SG

42 Switzerland CH

43 Tanzania TZ

44 Uzbekistan (Virtual) UZ

45 Indonesia ID

46 Ireland IE

47 Israel IL

48 Kazakhstan KZ

49 Kenya KE

50 Laos LA
№ Flag Country Code

51 Latvia LV

52 Lithuania LT

53 Macedonia MK

54 Malaysia MY

55 Mexico MX

56 Moldova MD

57 Morocco MA

58 Netherlands NL

59 New Zealand NZ

60 Nigeria NG

61 Paraguay PY

62 Philippines PH

63 Poland PL

64 Portugal PT

65 Romania RO

66 Russian Federation RU

67 Serbia RS

68 Slovakia SK

69 Slovenia SI
 № Flag Country Code

70 South Africa ZA

71 Sweden SE

72 Thailand TH

73 Turkey TR

74 Ukraine UA

75 Vietnam VN

Services list

If you do not find the service you need, then you can use the OTHER (opt19) service or contact support
to add the service you need.

№ Logo Service Code

1 1 OpenAI API (chatGPT, DALL-e 2) opt132

2 1cupis.ru opt251

3 22bet opt224

4 888casino opt22

5 Abbott opt242

6 Adidas & Nike opt86

7 Airbnb opt46

8 Alibaba (Taobao, 1688.com) opt61

9 Amazon opt44
№ Logo Service Code

10 AOL opt10

11 Apple opt131

12 autocosmos.com opt143

13 Avito opt59

14 Badoo opt56

15 BANDUS opt209

16 Bazos.sk opt138

17 Beget.com opt187

18 bet365 opt17

19 Betano (+BETANO.ro) opt192

20 BetFair opt25

21 Betmgm opt223

22 Bitpanda opt237

23 Blizzard opt78

24 blsspain-russia.com opt135

25 Bolt opt81

26 Brevo opt217

27 bumble opt145

28 bunq opt199

29 bwin opt137

30 Careem opt89
№ Logo Service Code

31 casa.it opt148

32 Cash App opt226

33 Cashrewards opt214

34 Casino Plus opt201

35 ChoTot opt176

36 CityMobil opt76

37 Claude (Anthropic) opt196

38 Clubhouse opt98

39 CoinBase opt112

40 CONTACT opt51

41 Craigslist opt26

42 Credit Karma opt124

43 CupidMedia opt157

44 Czech email services opt150

45 Deliveroo opt53

46 DenimApp opt204

47 DiDi opt92

48 Discord opt45

49 DistroKid opt232

50 Dodopizza + PapaJohns opt27

51 Doordash opt40
№ Logo Service Code

52 Drom.RU opt32

53 Drug Vokrug opt31

54 dundle opt136

55 EasyPay opt21

56 ENEBA opt200

57 ESX (abonamentesali.ro) opt248

58 EUROBET opt141

59 Facebook opt2

60 FastMail opt43

61 Fbet opt215

62 Feeld opt159

63 Fiverr opt6

64 fontbet opt139

65 foodora opt189

66 foodpanda opt115

67 Fortuna opt221

68 Fotostrana opt13

69 funpay opt142

70 G2A.COM opt68

71 Gameflip opt77

72 Gamers set (offgamers.com, G2A.com, seagm.com) opt28

№ Logo Service Code

73 GetsBet.ro opt179

74 GetTaxi opt35

75 GGbet opt188

76 GGPokerUK opt229

77 giocodigitale.it opt85

78 Glovo & Raketa opt108

79 goldbet.it opt240

80 Google (YouTube, Gmail) opt1

81 Google Voice opt140

82 GrabTaxi opt30

83 Grailed opt420

84 Grindr opt110

85 Happn opt155

86 HelloTalk opt203

87 hepsiburada opt238

88 Hey opt216

89 Hinge opt120

90 hopper opt144

91 HUAWEI opt166

92 ICard opt103

93 idealista.com opt165

94 ifood opt55
№ Logo Service Code

95 IMO opt111

96 inbox.lv opt167

97 Inboxdollars opt118

98 Instagram (+Threads) opt16

99 Ipsos opt193

100 IQOS opt243

101 JD.com opt94

102 KakaoTalk opt71

103 Klarna opt175

104 kleinanzeigen.de opt152

105 KoronaPay opt99

106 Kuper (SberMarket) opt97

107 kwiff.com opt129

108 Lajumate.ro opt195

109 Lalamove opt180

110 LAPOSTE opt182

111 LASVEGAS.RO opt222

112 Lazada opt60

113 Leboncoin opt164

114 Line Messenger opt37

№ Logo Service Code

115 LinkedIn opt8

116 Linode opt245

117 LiveScore opt42

118 LocalBitcoins opt105

119 Locanto.com opt114

120 Lyft opt75

121 Magnit opt126

122 Mail.RU opt33

123 Mail.ru Group opt4

124 Mamba opt100

125 Marktplaats opt171

126 Match opt250

127 maxline.by opt219

128 MiChat opt96

129 Microsoft (Azure, Bing, Skype, etc) opt15

130 mobileDE opt156

131 MOMO opt184

132 Monese opt121

133 MoneyLion opt47

134 MPSellers opt197

135 MrGreen opt211

№ Logo Service Code

136 MS Office 365 opt7

137 myopinions & erewards opt0

138 Naver opt73

139 Nectar opt198

140 NetBet opt95

141 Neteller opt116

142 Netflix opt101

143 NHNCloud opt202

144 NHNcorp (강남언니) opt177

145 Nico opt119

146 novibet.com opt151

147 OD opt5

148 OfferUp opt113

149 OkCupid opt230

150 OKX opt228

151 OLX + goods.ru opt70

152 onet.pl (Onet Konto) opt241

153 OTHER (no guarantee) opt19

154 OTHER (voice code) opt00019

155 OurTime opt212

156 Outlier opt246

157 OZON.ru opt181

№ Logo Service Code

158 Paddy Power opt109

159 Pari.ru opt169

160 Parimatch opt3

161 Payoneer opt162

162 PayPal + Ebay opt83

163 Paysafecard opt122

164 PAYSEND opt183

165 pm.by opt149

166 POF.com opt84

167 Prom.UA opt107

168 Proton Mail opt57

169 Publi24 opt207

170 Qiwi opt18

171 RadQuest opt247

172 Rambler.ru opt154

173 Revolut opt133

174 ROOMSTER opt153

175 Royal Canin opt170

176 RusDate opt186

177 Samokat opt185

178 Samsung opt174

179 Schibsted-konto opt134

№ Logo Service Code

180 Shopee opt48

181 Signal opt127

182 Sisal opt38

183 Skout opt49

184 Skrill opt117

185 Snapchat opt90

186 SNKRDUNK opt190

187 Solitaire Cash opt234

188 Steam opt58

189 subito.it opt146

190 Superbet opt249

191 Swagbucks opt125

192 Tango opt82

193 TANK.RU opt161

194 Taptap opt239

195 Taxi Maksim opt74

196 Telegram opt29

197 Telegram (voice code) opt00029

198 Tencent QQ opt34

199 Ticketmaster opt52

200 TikTok opt104

№ Logo Service Code

201 Tinder opt9

202 TLScontact opt235

203 TopCashback opt191

204 TOTOGAMING opt220

205 TransferGo opt218

206 TrueCaller opt233

207 Truth Social opt244

208 Twilio opt66

209 Twitch opt205

210 U By Prodia opt160

211 Uber opt72

212 Verse opt39

213 Viber opt11

214 Vinted opt130

215 VK (no guarantee) opt69

216 VonageVF opt178

217 VooV Meeting opt147

218 Waitomo opt213

219 WalletHub opt206

220 Walmart opt227

221 WEB.DE opt172

222 WebMoney&ENUM opt24

№ Logo Service Code

223 WeChat opt67

224 Weebly opt54

225 WESTSTEIN opt80

226 Whatnot opt231

227 WhatsAPP opt20

228 WhatsAPP (voice code) opt00020

229 Whoosh opt123

230 Wing Money opt106

231 Wise opt91

232 Wolt opt163

233 WooPlus opt208

234 X (Twitter) opt41

235 X World Wallet opt173

236 Yahoo opt65

237 Yalla.live opt88

238 Yandex&YooMoney opt23

239 Year13 opt236

240 Zalo opt158

241 Zasilkovna opt225

242 Zoho opt93

243 ZoomInfo opt194

All requests

Getting phone number

Request for receiving a phone number for a certain service

AUTHORIZATIONS: apikey

QUERY PARAMETERS

apikey string
required
Example: apikey=DSWAFvdedrE4
Your API key

service string
required
Example: service=opt4
Service code

country string
required
Example: country=RU
Country code

metod string
required
Example: metod=get_number
Method name

Responses

200

Success

RESPONSE SCHEMA: application/json

response string
Example: "2"
Status
 number string
Example: "9871234567"
Number to receive SMS

id string
Example: "25623"
Order ID

GET /priemnik.php?method=get_number

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/priemnik.php?apikey=DSWAFvdedrE4&service=opt4&cou
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy
{
"response": "2",
"number": "9871234567",
"id": "25623"
}

Getting SMS
Receiving an SMS for a certain service
In this method id parameter is indicated from the response to request for phone number get_number
 Note

If you get the response that a code from SMS hasn't been found yet, send request get_sms once
again 20 seconds later. Note, the server searches for SMS for 10 minutes. You need to send your
request within 10 minutes each 20 seconds per one request. That said, you receive a code from
SMS or error message.

Code Refinement
If you want to get re-SMS without closing the order (Code Refinement), then just on the method
get_sms add additional parameter sms=sms Example string:

https://smspva.com/priemnik.php?
metod=get_sms
&country=ru
&service=opt4
&id=25623
&apikey=DSWAFvdedrE4
&sms=sms

In this case, your order can not be closed and you may receive a re-SMS. Re-chargeable SMS. The cost
is the cost of an ordinary SMS for this service.

AUTHORIZATIONS: apikey

QUERY PARAMETERS

apikey string
required
Example: apikey=DSWAFvdedrE4
Your API key

service string
required
Example: service=opt4
Service code

country string
required
Example: country=RU
Country code

id string
required
Example: id=3421
ID of the order

metod string
required
Example: metod=get_sms
Method name
Responses

200

Success

RESPONSE SCHEMA: application/json

response string
Example: "2"
Status

number string
Example: "9871234567"
Number to receive SMS

sms string
Example: "234562"
Code from SMS

GET /priemnik.php?method=get_sms

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/priemnik.php?apikey=DSWAFvdedrE4&service=opt4&cou
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy
 {
"response": 2,
"number": "9871234567",
"sms": "234562"
}

Cancelling order
Get the user's balance information.

AUTHORIZATIONS: apikey

QUERY PARAMETERS

apikey string
required
Example: apikey=DSWAFvdedrE4
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

Responses

200

Success

RESPONSE SCHEMA: application/json

response string
Example: "1"
Status

balance string
Example: "385.00"
Current balance
 GET /priemnik.php?method=get_balance

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/priemnik.php?apikey=DSWAFvdedrE4&method=get_balan
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy
{
"response": "1",
"balance": "385.00"
}

Getting information about user balance

Get the user's balance and karma information.

AUTHORIZATIONS: apikey

QUERY PARAMETERS

apikey string
required
Example: apikey=DSWAFvdedrE4
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

service string
 required
Example: service=opt4
Services code (see services list)

metod string
required
Example: metod=get_userinfo
Method name

Responses

200

Success

RESPONSE SCHEMA: application/json

response integer
Example: "1"
Status

balance string
Example: "385.00"
Current balance

karma string
Example: "10"
Current rating value

GET /priemnik.php?method=get_userinfo

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/priemnik.php?apikey=DSWAFvdedrE4&service=opt4&met
--header 'apikey: REPLACE_KEY_VALUE'

Response samples
 200

Content type
application/json

Copy
{
"response": 1,
"balance": "385.00",
"karma": "10"
}

Cancelling order
Cancel the order to the number you received

AUTHORIZATIONS: apikey

QUERY PARAMETERS

apikey string
required
Example: apikey=DSWAFvdedrE4
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

service string
Example: service=opt4
Services code (see services list)

country string
Example: country=RU
Countries code (countries list)

id string
required
Example: id=3212
Order id

metod string
required
Example: metod=denial
Method name
Responses

200

Success

RESPONSE SCHEMA: application/json

response string
Example: "2"
Status

number string
Example: ""
Phone number

id string
Example: ""
Order id

GET /priemnik.php?method=denial

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/priemnik.php?apikey=DSWAFvdedrE4&service=opt4&cou
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy
 {
"response": "2",
"number": "",
"id": ""
}

Banning phone number

Report to the server that the number is already used

AUTHORIZATIONS: apikey

QUERY PARAMETERS

apikey string
required
Example: apikey=DSWAFvdedrE4
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

service string
required
Example: service=opt4
Services code (see services list)

id integer
required
Example: id=3212
Order id

metod string
required
Example: metod=ban
Method name

Responses

200

Success

RESPONSE SCHEMA: application/json

response string
 Example: "2"
Status

number string
Example: ""
Phone number

id string
Example: ""
Order id

GET /priemnik.php?method=ban

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/priemnik.php?apikey=DSWAFvdedrE4&service=opt4&id=
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy
{
"response": 2,
"number": "",
"id": ""
}

Removing old SMS for receiving new SMS

Checking phone number for receiving few sms ID is order identificator.

Note > > After checking phone number using get_clearsms, need to make get_sms request

AUTHORIZATIONS: apikey

QUERY PARAMETERS

apikey string
required
Example: apikey=DSWAFvdedrE4
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

service string
required
Example: service=opt4
Services code (see services list)

id string
required
Order id

metod string
required
Example: metod=get_clearsms
Method name

Responses

200

Success

RESPONSE SCHEMA: application/json

response string
Example: "2"
Status

clearsms string
Example: "ok"
Result of operation
 GET /priemnik.php?method=get_clearsms

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/priemnik.php?apikey=DSWAFvdedrE4&service=opt4&id=
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy
{
"response": "2",
"clearsms": "ok"
}

Getting count of available phones

Request for the amount of free activations for a certain service

AUTHORIZATIONS: apikey

QUERY PARAMETERS

apikey string
required
Example: apikey=DSWAFvdedrE4
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

service string
 required
Example: service=opt4
Services code (see services list)

country string
required
Example: country=RU
Countries code (countries list)

Responses

200

Success

RESPONSE SCHEMA: application/json

service string
Example: "opt5"
Services code (see services list)

online integer
Example: "128"
Number of available now

total integer
Example: "228"
Total available

forTotal integer
Example: "10"
Available now for call forwarding

forOnline integer
Example: "20"
Total available for call forwarding

country string
Example: "RU"
Country code

GET /priemnik.php?method=get_count_new
Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/priemnik.php?apikey=DSWAFvdedrE4&service=opt4&cou
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy
{
"service": "opt5",
"online": 128,
"total": 228,
"forTotal": 10,
"forOnline": 20,
"country": "RU"
}

Getting prices for SMS

Request the current price for SMS for a country and service

AUTHORIZATIONS: apikey

QUERY PARAMETERS

apikey string
required
Example: apikey=DSWAFvdedrE4
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section
 service string
required
Example: service=opt4
Services code (see services list)

country string
required
Example: country=RU
Countries code (countries list)

Responses

200

Success

RESPONSE SCHEMA: application/json

response string
Example: "1"
Status

country string
Example: "EN"
Countries code (countries list)

service string
Example: "opt4"
Services code (see services list)

price string
Example: "0.50"
The price of receiving 1 SMS

GET /priemnik.php?method=get_service_price

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
 curl --request GET \
--url 'https://smspva.com/priemnik.php?apikey=DSWAFvdedrE4&service=opt4&cou
--header 'apikey: REPLACE_KEY_VALUE'

Response samples

200

Content type
application/json

Copy
{
"response": 1,
"country": "EN",
"service": "opt4",
"price": "0.50"
}

Checking availability for receiving SMS

Checking the numbers for multiple SMS In this method, number parameter specifies the number that
you want to check.

Note

Following the successful check of a number, send a request for getting the number - get_number
ALSO with number parameter. To check SMS send a request for SMS get_sms according to
conditions

AUTHORIZATIONS: apikey

QUERY PARAMETERS

apikey string
required
Your API key
You can find it on the website in the top right drop-down menu in the Profile
and APIKEY section

number string
required
Phone number

service string
 required
Services code (see services list)

Responses

200

Success

RESPONSE SCHEMA: application/json

One of
Success Error. Phone numbers is incorrect Error. Previous order not found

Error. Previous order not found Error. Modem is busy Error. Modem is busy

response string
Example: "ok"
Status

number string
Example: "9685156912"
Number to receive SMS

id integer
Example: "25623"
Order ID

GET /priemnik.php?method=get_proverka

Request samples

Shell + Curl Php + Curl Node + Request Python + Python3

Copy
curl --request GET \
--url 'https://smspva.com/priemnik.php?apikey=SOME_STRING_VALUE&number=SOME
--header 'apikey: REPLACE_KEY_VALUE'

Response samples
 200

Content type
application/json

Example
Success

Copy
{
"response": "ok",
"number": "9685156912",
"id": 25623
}

General provisions and list of errors

Errors list

Response code Meaning

5 You have exceeded the number of requests per minute.

You will be banned for 10 minutes, because scored negative

6
karma.

You have exceeded the number of concurrent streams. SMS Wait

7
from previous orders.

API KEY not received! Invalid API KEY has been entered

API KEY NOT FOUND! Invalid API KEY has been entered

BANNED User banned

Service NOT FOUND! Service not found

 Response code Meaning

UNKNOWN SERVICE OR
Service or country not found
COUNTRY

Important recommendations

You can find APIKEY on the website in the top right

drop-down menu in the Profile and APIKEY section

If you haven't received SMS within 580 seconds (9 minutes 40 seconds), make sure to ban the number
you've got.

If you ban the number when 10 minutes expired, the number you got won't be banned and might be
given once again since the system keeps request ID in the base for 10 minute, after that ID is deleted
from the base.

Up to 40 connections are allowed per minute.

Do interval of 4 - 5 seconds between any queries! Otherwise, you will not be able to fully use the API,
because Your requests will be rejected by the server!.