Change theme

We added UnionPay in payment methods! For our Chinese users :)

Last modified at 2022/07/01

Running queries to API

To call up API SimSms method you need to execute HTTP GET request to indicated URL:

https://smspva.com/priemnik.php?
	metod={METHOD}
	&service={SERVICE}
	&id={ID}
	&apikey={API_KEY}
	&operator={OPERATOR}

{METHOD} - Method name from API methods description

{SERVICE} - Service name from the service list

{ID} - Request ID

{API_KEY} - Your API Key in the system

{OPERATOR} - (Additional parameter can be omitted) Beeline_RU, MTS_RU, Megafon_RU, Beeline_KZ, Tele2_KZ, Activ_KZ, Altel_KZ, Lifecell_UA, Kyivstar_UA, Vodafone_UA

Provider selection can take on the following values: Beeline_RU, MTS_RU, Megafon_RU. If not specified, a number of random provider will be given.

Example

https://smspva.com/priemnik.php?
	metod=get_balance
	&service=opt4
	&apikey=DSWAFvdedrE4
	&operator=MTS_RU


In response to such request you'll get a JSON answer.


Important

Up to 100 connections are allowed per 1 second.

Country list

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


Flag
Country
Code
1
RU
  Russian Federation
RU
2
CA
  Canada
CA
3
US
  United States
US
4
UK
  Unt. Kingdom
UK
5
FR
  France
FR
6
DE
  Germany
DE
7
IT
  Italy
IT
8
ES
  Spain
ES
9
AL
  Albania
AL
10
AR
  Argentina
AR
11
AT
  Austria
AT
12
BD
  Bangladesh
BD
13
BA
  Bos. and Herz.
BA
14
BR
  Brazil
BR
15
BG
  Bulgaria
BG
16
KH
  Cambodia
KH
17
CL
  Chile
CL
18
CO
  Colombia
CO
19
HR
  Croatia
HR
20
CY
  Cyprus
CY
21
CZ
  Czech Republic
CZ
22
DK
  Denmark
DK
23
DO
  Dominicana
DO
24
EG
  Egypt (Virtual)
EG
25
EE
  Estonia
EE
26
FI
  Finland
FI
27
GE
  Georgia
GE
28
GH
  Ghana (Virtual)
GH
29
GI
  Gibraltar
GI
30
GR
  Greece
GR
31
HU
  Hungary
HU
32
IN
  India
IN
33
XK
  Kosovo
XK
34
PK
  Pakistan (Virtual)
PK
35
IQ
  Iraq
IQ
36
ID
  Indonesia
ID
37
IE
  Ireland
IE
38
IL
  Israel
IL
39
KZ
  Kazakhstan
KZ
40
KE
  Kenya
KE
41
LA
  Laos
LA
42
LV
  Latvia
LV
43
LT
  Lithuania
LT
44
MK
  Macedonia
MK
45
MY
  Malaysia
MY
46
MX
  Mexico
MX
47
MD
  Moldova
MD
48
MA
  Morocco
MA
49
NL
  Netherlands
NL
50
NZ
  New Zealand
NZ
51
NG
  Nigeria
NG
52
PY
  Paraguay
PY
53
PH
  Philippines
PH
54
PL
  Poland
PL
55
PT
  Portugal
PT
56
RO
  Romania
RO
57
RS
  Serbia
RS
58
SK
  Slovakia
SK
59
SI
  Slovenia
SI
60
ZA
  South Africa
ZA
61
SE
  Sweden
SE
62
TH
  Thailand
TH
63
TR
  Turkey
TR
64
UA
  Ukraine
UA
65
VN
  Vietnam
VN

Service list


Logo
Service
Code
1
opt132
  1 OpenAI API (chatGPT, DALL-e 2)
opt132
2
opt22
  888casino
opt22
3
opt86
  Adidas & Nike
opt86
4
opt46
  Airbnb
opt46
5
opt61
  Alibaba (Taobao, 1688.com)
opt61
6
opt44
  Amazon
opt44
7
opt10
  AOL
opt10
8
opt131
  Apple
opt131
9
opt143
  autocosmos.com
opt143
10
opt59
  Avito
opt59
11
opt56
  Badoo
opt56
12
opt138
  Bazos.sk
opt138
13
opt187
  Beget.com
opt187
14
opt17
  bet365
opt17
15
opt128
  BETANO.ro
opt128
16
opt25
  BetFair
opt25
17
opt78
  Blizzard
opt78
18
opt135
  blsspain-russia.com
opt135
19
opt81
  Bolt
opt81
20
opt145
  bumble
opt145
21
opt137
  bwin
opt137
22
opt89
  Careem
opt89
23
opt148
  casa.it
opt148
24
opt176
  ChoTot
opt176
25
opt76
  CityMobil
opt76
26
opt98
  Clubhouse
opt98
27
opt112
  CoinBase
opt112
28
opt51
  CONTACT
opt51
29
opt26
  Craigslist
opt26
30
opt124
  Credit Karma
opt124
31
opt157
  CupidMedia
opt157
32
opt150
  Czech email services
opt150
33
opt53
  Deliveroo
opt53
34
opt92
  DiDi
opt92
35
opt45
  Discord
opt45
36
opt27
  Dodopizza + PapaJohns
opt27
37
opt40
  Doordash
opt40
38
opt32
  Drom.RU
opt32
39
opt31
  Drug Vokrug
opt31
40
opt136
  dundle
opt136
41
opt21
  EasyPay
opt21
42
opt141
  EUROBET
opt141
43
opt2
  Facebook
opt2
44
opt43
  FastMail
opt43
45
opt159
  Feeld
opt159
46
opt6
  Fiverr
opt6
47
opt139
  fontbet
opt139
48
opt189
  foodora
opt189
49
opt115
  foodpanda
opt115
50
opt13
  Fotostrana
opt13
51
opt142
  funpay
opt142
52
opt68
  G2A.COM
opt68
53
opt77
  Gameflip
opt77
54
opt28
  Gamers set (offgamers.com, G2A.com, seagm.com)
opt28
55
opt179
  GetsBet.ro
opt179
56
opt35
  GetTaxi
opt35
57
opt188
  GGbet
opt188
58
opt85
  giocodigitale.it
opt85
59
opt108
  Glovo | Raketa
opt108
60
opt1
  Google (YouTube, Gmail)
opt1
61
opt140
  Google Voice
opt140
62
opt30
  GrabTaxi
opt30
63
opt420
  Grailed
opt420
64
opt110
  Grindr
opt110
65
opt155
  Happn
opt155
66
opt120
  Hinge
opt120
67
opt144
  hopper
opt144
68
opt166
  HUAWEI
opt166
69
opt103
  ICard
opt103
70
opt165
  idealista.com
opt165
71
opt55
  ifood
opt55
72
opt111
  IMO
opt111
73
opt167
  inbox.lv
opt167
74
opt118
  Inboxdollars
opt118
75
opt16
  Instagram (+Threads)
opt16
76
opt94
  JD.com
opt94
77
opt71
  KakaoTalk
opt71
78
opt175
  Klarna
opt175
79
opt152
  kleinanzeigen.de
opt152
80
opt99
  KoronaPay
opt99
81
opt129
  kwiff.com
opt129
82
opt180
  Lalamove
opt180
83
opt182
  LAPOSTE
opt182
84
opt60
  Lazada
opt60
85
opt164
  Leboncoin
opt164
86
opt37
  Line Messenger
opt37
87
opt8
  LinkedIn
opt8
88
opt42
  LiveScore
opt42
89
opt105
  LocalBitcoins
opt105
90
opt114
  Locanto.com
opt114
91
opt75
  Lyft
opt75
92
opt126
  Magnit
opt126
93
opt33
  Mail.RU
opt33
94
opt4
  Mail.ru Group
opt4
95
opt100
  Mamba
opt100
96
opt171
  Marktplaats
opt171
97
opt96
  MiChat
opt96
98
opt156
  mobileDE
opt156
99
opt184
  MOMO
opt184
100
opt121
  Monese
opt121
101
opt47
  MoneyLion
opt47
102
opt7
  MS Office 365
opt7
103
opt15
  MS, Bing, HotMail, Azure
opt15
104
opt0
  myopinions & erewards
opt0
105
opt73
  Naver
opt73
106
opt95
  NetBet
opt95
107
opt116
  Neteller
opt116
108
opt101
  Netflix
opt101
109
opt177
  NHNcorp
opt177
110
opt119
  Nico
opt119
111
opt151
  novibet.com
opt151
112
opt5
  OD
opt5
113
opt113
  OfferUp
opt113
114
opt70
  OLX + goods.ru
opt70
115
opt19
  OTHER (no guarantee)
opt19
116
opt00019
  OTHER (voice code)
opt00019
117
opt181
  OZON.ru
opt181
118
opt109
  Paddy Power
opt109
119
opt169
  Pari.ru
opt169
120
opt3
  Parimatch
opt3
121
opt162
  Payoneer
opt162
122
opt83
  PayPal + Ebay
opt83
123
opt122
  Paysafecard
opt122
124
opt183
  PAYSEND
opt183
125
opt149
  pm.by
opt149
126
opt84
  POF.com
opt84
127
opt107
  Prom.UA
opt107
128
opt57
  Proton Mail
opt57
129
opt154
  Rambler.ru
opt154
130
opt133
  Revolut
opt133
131
opt153
  ROOMSTER
opt153
132
opt170
  Royal Canin
opt170
133
opt186
  RusDate
opt186
134
opt185
  Samokat
opt185
135
opt174
  Samsung
opt174
136
opt97
  SberMarket
opt97
137
opt134
  Schibsted-konto
opt134
138
opt48
  Shopee
opt48
139
opt127
  Signal
opt127
140
opt38
  Sisal
opt38
141
opt49
  Skout
opt49
142
opt117
  Skrill
opt117
143
opt90
  Snapchat
opt90
144
opt190
  SNKRDUNK
opt190
145
opt58
  Steam
opt58
146
opt146
  subito.it
opt146
147
opt125
  Swagbucks
opt125
148
opt82
  Tango
opt82
149
opt161
  TANK.RU
opt161
150
opt74
  Taxi Maksim
opt74
151
opt29
  Telegram
opt29
152
opt00029
  Telegram (voice code)
opt00029
153
opt34
  Tencent QQ
opt34
154
opt52
  Ticketmaster
opt52
155
opt104
  TikTok
opt104
156
opt9
  Tinder
opt9
157
opt66
  Twilio
opt66
158
opt41
  Twitter
opt41
159
opt160
  U By Prodia
opt160
160
opt72
  Uber
opt72
161
opt39
  Verse
opt39
162
opt11
  Viber
opt11
163
opt130
  Vinted
opt130
164
opt69
  VK
opt69
165
opt178
  VonageVF
opt178
166
opt147
  VooV Meeting
opt147
167
opt172
  WEB.DE
opt172
168
opt24
  WebMoney&ENUM
opt24
169
opt67
  WeChat
opt67
170
opt54
  Weebly
opt54
171
opt80
  WESTSTEIN
opt80
172
opt20
  WhatsAPP
opt20
173
opt00020
  WhatsAPP (voice code)
opt00020
174
opt123
  Whoosh
opt123
175
opt106
  Wing Money
opt106
176
opt91
  Wise
opt91
177
opt163
  Wolt
opt163
178
opt173
  X World Wallet
opt173
179
opt65
  Yahoo
opt65
180
opt88
  Yalla.live
opt88
181
opt23
  Yandex&YooMoney
opt23
182
opt158
  Zalo
opt158
183
opt93
  Zoho
opt93

Return errors codes

{"response":"5","number":null,"id":0,"text":null,"extra":null,"sms":null} - You have exceeded the number of requests per minute


{"response":"6","number":null,"id":0,"text":null,"extra":null,"sms":null} - You will be banned for 10 minutes, because scored negative karma


{"response":"7","number":null,"id":0,"text":null,"extra":null,"sms":null} - You have exceeded the number of concurrent streams. SMS Wait from previous orders


API KEY не получен! - Invalid API KEY has been entered


Недостаточно средств! - Insufficient funds


Превышено количество попыток! - Set a longer interval between calls to API server


Произошла неизвестная ошибка. - Try to repeat your request later.


Неверный запрос. - Check the request syntax and the list of parameters used (can be found on the page with method description).


Произошла внутренняя ошибка сервера. - Try to repeat your request later.


Important recommendations

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!.

API methods description

Method get_balance

User's balance request

Example

https://smspva.com/priemnik.php?
	metod=get_balance
	&service=opt4
	&apikey=DSWAFvdedrE4


Result

Provides a JSON answer after successful execution:

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


Errors codes

Error may occur while executing:

{"response":"error","error_msg":"Not id or not user balance"}

Method get_userinfo

User's balance request and karma

Example

https://smspva.com/priemnik.php?
	metod=get_userinfo
	&service=opt4
	&apikey=DSWAFvdedrE4


Result

Provides a JSON answer after successful execution:

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


Errors codes

Error may occur while executing:

{"response":"error","error_msg":"Not id or not user balance"}

Method get_count_new

Request for the amount of free activations for a certain service


If you need to know count of available numbers for another country then you can set "country" parametr to spec value. For example, country=KZ for Kazakhstan numbers.


Example

https://smspva.com/priemnik.php?
	metod=get_count_new
	&service=opt4
	&apikey=DSWAFvdedrE4
	&country=RU


Result

JSON:


      {
        service: "opt5",    service opt
        online: 128,        available now
        total: 228,         available total
        forTotal: 10,       available now for call forwarding
        forOnline: 20,      available total for call forwarding
        country: "RU"       sim's country
      }
      


Method get_service_price

Request current price sms for country and service

Example

https://smspva.com/priemnik.php?
	metod=get_service_price
	&country=RU
	&service=opt4
	&apikey=DSWAFvdedrE4


Result

Provides a JSON answer after successful execution:

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


Errors codes

Error may occur while executing:

1) Common errors may occur. Their description is in the list - Return errors codes

Method get_number

Request for receiving a phone number for a certain service

Example

https://smspva.com/priemnik.php?
	metod=get_number
	&country=RU
	&service=opt4
	&apikey=DSWAFvdedrE4


Result

Provides a JSON answer after successful execution:

{"response":"1","number":"9871234567","id":"25623"}


Errors codes

Error may occur while executing:

1) JSON response - {"response":"2","number":"","id":"-1"} - numbers are already taken, try to get a number again in 60 seconds.
2) Common errors may occur. Their description is in the list - Return errors codes

Method ban

Report to the server the number is already used


In this method id parameter is indicated from the response to request for phone number get_number


Example

https://smspva.com/priemnik.php?
	metod=ban
	&service=opt4
	&apikey=DSWAFvdedrE4
	&id=25623


Result

Provides a JSON answer after successful execution:

{"responce":"1","number":"","id":"25623"}


Errors codes

Error may occur while executing:

1) JSON response -

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

2) Common errors may occur. Their description is in the list - Return errors codes

Method get_sms

Receiving a SMS for a certain service


In this method id parameter is indicated from the response to request for phone number get_number


Example

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


Result

Provides a JSON answer after successful execution, if code from SMS hasn't been found yet:

{"response":"2","number":"9871234567","sms":null}

Provides a JSON answer after successful execution, if code from SMS hasn't been found yet:

{"response":"1","number":"9871234567","sms":"234562"}

Provides a JSON answer after successful execution, if you suddenly missed the first answer with response = 1:

{"response":"4"}


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.


Errors codes

Error may occur while executing:

1) JSON response - {"response":"3","number":"null","sms":null} - no such SMS or invalid request ID or SMS waiting time has expired (no more than 10 minutes)
2) Common errors may occur. Their description is in the list - Return errors codes

Method denial

Cancel the order to number you got


In this method id parameter is indicated from the response to request for phone number get_number


Example

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


Result

Provides a JSON answer after successful execution:

{"responce":"1","number":"","id":25623}


Errors codes

Error may occur while executing:

1) JSON response -

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


2) Common errors may occur. Their description is in the list - Return errors codes

Method get_clearsms

Checking phone number for receiving few sms


ID is order identificator.


Example


https://smspva.com/priemnik.php?
  metod=get_clearsms
  &service=opt4
  &id=25623
  &apikey=DSWAFvdedrE4.


Result

After successfully execution will be received JSON:

{"responce":"1","clearsms":"ok"}


Note

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


Erros

Error may occur while executing:

1) {"response":"2","clearsms":"non_ok"}

2) Common errors may occur. Their description is in the list - Return errors codes

Method get_proverka

Checking the numbers for multiple SMS


In this method, number parameter specifies the number that you want to check.


Example

https://smspva.com/priemnik.php?
	metod=get_proverka
	&service=opt4
	&number=9685156912
	&apikey=DSWAFvdedrE4.


Result

Provides a JSON answer after successful execution:

{"responce":"ok","number":"9685156912","id":25623}


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


Errors codes

Error may occur while executing:

1) {"response":"error","error_msg":"Number shall consist of 10 digits!"} - You didn't order a number for this service

2) {"response":"error","error_msg":"Such a number you did not order for the service"} - You didn't order a number for this service

3) {"response":"modem_busy","error_msg":"The modem is busy, try to order in 5 minutes"} - GSM module is busy, try to repeat your request 5 minutes later.

4) {"response":"modem_busy","not_number":"This number is no longer in the system"} - There's no such number in the system any longer.

5) Common errors may occur. Their description is in the list - Return errors codes

Method balance_sim

Receiving SIM card balance


This method works only for avito+forwarding service.


Example

https://smspva.com/priemnik.php?
	metod=balance_sim
	&service=opt59
	&id=25623
	&apikey=DSWAFvdedrE4.


Result

Provides a JSON answer after successful execution:

{"responce":1,"amount":0}


Errors codes

Error may occur while executing:

1) {"response":2,"amount":"error_amount"} - SIM card balance info hasn't been received

2) Common errors may occur. Their description is in the list - Return errors codes

Method get_2fa

Obtaining 2FA authorization code from Google, Microsoft, etc. by secret key


Example

https://smspva.com/priemnik.php?
	metod=get_2fa
	&secret=1234567890
	&apikey=DSWAFvdedrE4.


Result

Provides a JSON answer after successful execution:

{"response":1,"code2fa":"723152","secret":"1234567890","tonew":24}


How to use the API!

Let's say you write the registrar accounts in Vkontakte.


The registrar you work through a proxy.


First we install and generate the proxy name or take from the list.


Go to the site Vkontakte, which introduce a name, specify gender if requested. Click on the register button.


Next Vkontakte invites us to enter a phone number. Now we turn to our API, and learn balance on request - https://smspva.com/priemnik.php?metod=get_balance&service=opt4&apikey=DSWAFvdedrE4


In response to the request for the balance of the following answer comes to us - {"response":"1","balance":"385.00"}, If you write via PHP, unpack it via the function json_decode. If you use the built-in tester Zennoposter use regular expressions and unpack via regular season. In general, we need to get the number of the response comes after balance. As a result, we've got the number 385.


Now compare if the resulting number is less than 10, close the project.


If more than 10, then send a request for a phone number - https://smspva.com/priemnik.php?metod=get_number&country=ru&service=opt4&id=1&apikey=DSWAFvdedrE4


If you have received such a response - {"response":"1","number":"9257222005","id":4453221,"text":null,"extra":"Megafon_RU",
"pass":null,"sms":null,"balanceOnPhone":0}


Unpack the answer, write the id from the query in a variable and enter the resulting number in the registration in the VC and push the button to get the code.


When the answer came {"response":"2","number":"","id":"-1"}, means phone numbers are busy, we will send a second request for a phone number (get_number) after 30 seconds.


If the Vkontakte wrote that the phone number can not be used, then we send the number to the ban on request -https://smspva.com/priemnik.php?metod=ban&service=opt4&apikey=DSWAFvdedrE4&id=4453221


If you missed Vkontakte number phone, then we expect the code and test it to obtain through a request -https://smspva.com/priemnik.php?metod=get_sms&country=ru&service=opt4&id=4453221&apikey=DSWAFvdedrE4 where in the parameter ID indicating the ID obtained from the request for accommodation (get_number)


If, in response to a request received a response: {"response":"2","number":"9871234567","sms":null}, We pause of 30 seconds and send a request for a new SMS.


If the answer had come so - {"response":"3","number":"null","sms":null} SMS means no or an incorrect query Haydee or SMS waiting period has expired (not more than 10 minutes)


If the answer had come so - {"response":"1","number":"9871234567","sms":''234562'}. SMS found, the code of the SMS is contained after the word SMS.


Enter the confirmation code Vkontakte and click continue.


If you for some reason want to stop receiving numbers (such as accidentally ordered), submit a request to cancel number phone - https://smspva.com/priemnik.php?metod=denial&country=ru&service=opt4&id=4453221&apikey=DSWAFvdedrE4


Everything here is the whole process of getting the code using our API.


 

FLOW DIAGRAM

Download flow diagram as PDF [attachment=5]