Change theme

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
AU
  Australia
AU
12
AT
  Austria
AT
13
BD
  Bangladesh
BD
14
BA
  Bos. and Herz.
BA
15
BR
  Brazil
BR
16
BG
  Bulgaria
BG
17
KH
  Cambodia
KH
18
CL
  Chile
CL
19
CO
  Colombia
CO
20
HR
  Croatia
HR
21
CY
  Cyprus
CY
22
CZ
  Czech Republic
CZ
23
DK
  Denmark
DK
24
DO
  Dominicana
DO
25
EG
  Egypt
EG
26
EE
  Estonia
EE
27
FI
  Finland
FI
28
GE
  Georgia
GE
29
GH
  Ghana (Virtual)
GH
30
GI
  Gibraltar
GI
31
GR
  Greece
GR
32
HK
  Hong Kong
HK
33
HU
  Hungary
HU
34
IN
  India
IN
35
KG
  Kyrgyzstan (Virtual)
KG
36
NO
  Norway
NO
37
PK
  Pakistan (Virtual)
PK
38
SG
  Singapore
SG
39
TZ
  Tanzania
TZ
40
UZ
  Uzbekistan (Virtual)
UZ
41
IQ
  Iraq
IQ
42
ID
  Indonesia
ID
43
IE
  Ireland
IE
44
IL
  Israel
IL
45
KZ
  Kazakhstan
KZ
46
KE
  Kenya
KE
47
LA
  Laos
LA
48
LV
  Latvia
LV
49
LT
  Lithuania
LT
50
MK
  Macedonia
MK
51
MY
  Malaysia
MY
52
MX
  Mexico
MX
53
MA
  Morocco
MA
54
NL
  Netherlands
NL
55
NG
  Nigeria
NG
56
PY
  Paraguay
PY
57
PH
  Philippines
PH
58
PL
  Poland
PL
59
PT
  Portugal
PT
60
RO
  Romania
RO
61
RS
  Serbia
RS
62
SK
  Slovakia
SK
63
SI
  Slovenia
SI
64
ZA
  South Africa
ZA
65
SE
  Sweden
SE
66
TH
  Thailand
TH
67
UA
  Ukraine
UA
68
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
opt209
  BANDUS
opt209
13
opt138
  Bazos.sk
opt138
14
opt187
  Beget.com
opt187
15
opt17
  bet365
opt17
16
opt192
  Betano
opt192
17
opt128
  BETANO.ro
opt128
18
opt25
  BetFair
opt25
19
opt223
  Betmgm
opt223
20
opt78
  Blizzard
opt78
21
opt135
  blsspain-russia.com
opt135
22
opt81
  Bolt
opt81
23
opt217
  Brevo
opt217
24
opt145
  bumble
opt145
25
opt199
  bunq
opt199
26
opt137
  bwin
opt137
27
opt89
  Careem
opt89
28
opt148
  casa.it
opt148
29
opt214
  Cashrewards
opt214
30
opt201
  Casino Plus
opt201
31
opt176
  ChoTot
opt176
32
opt76
  CityMobil
opt76
33
opt196
  Claude (Anthropic)
opt196
34
opt98
  Clubhouse
opt98
35
opt112
  CoinBase
opt112
36
opt51
  CONTACT
opt51
37
opt26
  Craigslist
opt26
38
opt124
  Credit Karma
opt124
39
opt157
  CupidMedia
opt157
40
opt150
  Czech email services
opt150
41
opt53
  Deliveroo
opt53
42
opt204
  DenimApp
opt204
43
opt92
  DiDi
opt92
44
opt45
  Discord
opt45
45
opt27
  Dodopizza + PapaJohns
opt27
46
opt40
  Doordash
opt40
47
opt32
  Drom.RU
opt32
48
opt31
  Drug Vokrug
opt31
49
opt136
  dundle
opt136
50
opt21
  EasyPay
opt21
51
opt200
  ENEBA
opt200
52
opt141
  EUROBET
opt141
53
opt2
  Facebook
opt2
54
opt43
  FastMail
opt43
55
opt215
  Fbet
opt215
56
opt159
  Feeld
opt159
57
opt6
  Fiverr
opt6
58
opt139
  fontbet
opt139
59
opt189
  foodora
opt189
60
opt115
  foodpanda
opt115
61
opt221
  Fortuna
opt221
62
opt13
  Fotostrana
opt13
63
opt142
  funpay
opt142
64
opt68
  G2A.COM
opt68
65
opt77
  Gameflip
opt77
66
opt28
  Gamers set (offgamers.com, G2A.com, seagm.com)
opt28
67
opt179
  GetsBet.ro
opt179
68
opt35
  GetTaxi
opt35
69
opt188
  GGbet
opt188
70
opt85
  giocodigitale.it
opt85
71
opt108
  Glovo & Raketa
opt108
72
opt1
  Google (YouTube, Gmail)
opt1
73
opt140
  Google Voice
opt140
74
opt30
  GrabTaxi
opt30
75
opt420
  Grailed
opt420
76
opt110
  Grindr
opt110
77
opt155
  Happn
opt155
78
opt203
  HelloTalk
opt203
79
opt216
  Hey
opt216
80
opt120
  Hinge
opt120
81
opt144
  hopper
opt144
82
opt166
  HUAWEI
opt166
83
opt103
  ICard
opt103
84
opt165
  idealista.com
opt165
85
opt55
  ifood
opt55
86
opt111
  IMO
opt111
87
opt167
  inbox.lv
opt167
88
opt118
  Inboxdollars
opt118
89
opt16
  Instagram (+Threads)
opt16
90
opt193
  Ipsos
opt193
91
opt94
  JD.com
opt94
92
opt71
  KakaoTalk
opt71
93
opt175
  Klarna
opt175
94
opt152
  kleinanzeigen.de
opt152
95
opt99
  KoronaPay
opt99
96
opt129
  kwiff.com
opt129
97
opt195
  Lajumate.ro
opt195
98
opt180
  Lalamove
opt180
99
opt182
  LAPOSTE
opt182
100
opt222
  LASVEGAS.RO
opt222
101
opt60
  Lazada
opt60
102
opt164
  Leboncoin
opt164
103
opt37
  Line Messenger
opt37
104
opt8
  LinkedIn
opt8
105
opt42
  LiveScore
opt42
106
opt105
  LocalBitcoins
opt105
107
opt114
  Locanto.com
opt114
108
opt75
  Lyft
opt75
109
opt126
  Magnit
opt126
110
opt33
  Mail.RU
opt33
111
opt4
  Mail.ru Group
opt4
112
opt100
  Mamba
opt100
113
opt171
  Marktplaats
opt171
114
opt219
  maxline.by
opt219
115
opt96
  MiChat
opt96
116
opt15
  Microsoft (Azure, Bing, Skype, etc)
opt15
117
opt156
  mobileDE
opt156
118
opt184
  MOMO
opt184
119
opt121
  Monese
opt121
120
opt47
  MoneyLion
opt47
121
opt197
  MPSellers
opt197
122
opt211
  MrGreen
opt211
123
opt7
  MS Office 365
opt7
124
opt0
  myopinions & erewards
opt0
125
opt73
  Naver
opt73
126
opt198
  Nectar
opt198
127
opt95
  NetBet
opt95
128
opt116
  Neteller
opt116
129
opt101
  Netflix
opt101
130
opt202
  NHNCloud
opt202
131
opt177
  NHNcorp (강남언니)
opt177
132
opt119
  Nico
opt119
133
opt151
  novibet.com
opt151
134
opt5
  OD
opt5
135
opt113
  OfferUp
opt113
136
opt70
  OLX + goods.ru
opt70
137
opt19
  OTHER (no guarantee)
opt19
138
opt00019
  OTHER (voice code)
opt00019
139
opt212
  OurTime
opt212
140
opt181
  OZON.ru
opt181
141
opt109
  Paddy Power
opt109
142
opt169
  Pari.ru
opt169
143
opt3
  Parimatch
opt3
144
opt162
  Payoneer
opt162
145
opt83
  PayPal + Ebay
opt83
146
opt122
  Paysafecard
opt122
147
opt183
  PAYSEND
opt183
148
opt149
  pm.by
opt149
149
opt84
  POF.com
opt84
150
opt107
  Prom.UA
opt107
151
opt57
  Proton Mail
opt57
152
opt207
  Publi24
opt207
153
opt154
  Rambler.ru
opt154
154
opt133
  Revolut
opt133
155
opt153
  ROOMSTER
opt153
156
opt170
  Royal Canin
opt170
157
opt186
  RusDate
opt186
158
opt185
  Samokat
opt185
159
opt174
  Samsung
opt174
160
opt97
  SberMarket
opt97
161
opt134
  Schibsted-konto
opt134
162
opt48
  Shopee
opt48
163
opt127
  Signal
opt127
164
opt38
  Sisal
opt38
165
opt49
  Skout
opt49
166
opt117
  Skrill
opt117
167
opt90
  Snapchat
opt90
168
opt190
  SNKRDUNK
opt190
169
opt58
  Steam
opt58
170
opt146
  subito.it
opt146
171
opt125
  Swagbucks
opt125
172
opt82
  Tango
opt82
173
opt161
  TANK.RU
opt161
174
opt74
  Taxi Maksim
opt74
175
opt29
  Telegram
opt29
176
opt00029
  Telegram (voice code)
opt00029
177
opt34
  Tencent QQ
opt34
178
opt52
  Ticketmaster
opt52
179
opt104
  TikTok
opt104
180
opt9
  Tinder
opt9
181
opt191
  TopCashback
opt191
182
opt220
  TOTOGAMING
opt220
183
opt218
  TransferGo
opt218
184
opt66
  Twilio
opt66
185
opt205
  Twitch
opt205
186
opt41
  Twitter
opt41
187
opt160
  U By Prodia
opt160
188
opt72
  Uber
opt72
189
opt39
  Verse
opt39
190
opt11
  Viber
opt11
191
opt130
  Vinted
opt130
192
opt69
  VK
opt69
193
opt178
  VonageVF
opt178
194
opt147
  VooV Meeting
opt147
195
opt213
  Waitomo
opt213
196
opt206
  WalletHub
opt206
197
opt172
  WEB.DE
opt172
198
opt24
  WebMoney&ENUM
opt24
199
opt67
  WeChat
opt67
200
opt54
  Weebly
opt54
201
opt80
  WESTSTEIN
opt80
202
opt20
  WhatsAPP
opt20
203
opt00020
  WhatsAPP (voice code)
opt00020
204
opt123
  Whoosh
opt123
205
opt106
  Wing Money
opt106
206
opt91
  Wise
opt91
207
opt163
  Wolt
opt163
208
opt208
  WooPlus
opt208
209
opt173
  X World Wallet
opt173
210
opt65
  Yahoo
opt65
211
opt88
  Yalla.live
opt88
212
opt23
  Yandex&YooMoney
opt23
213
opt158
  Zalo
opt158
214
opt93
  Zoho
opt93
215
opt194
  ZoomInfo
opt194

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]