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
TR
  Turkey
TR
68
UA
  Ukraine
UA
69
VN
  Vietnam
VN

Service list


Logo
Service
Code
1
opt132
  1 OpenAI API (chatGPT, DALL-e 2)
opt132
2
opt224
  22bet
opt224
3
opt22
  888casino
opt22
4
opt86
  Adidas & Nike
opt86
5
opt46
  Airbnb
opt46
6
opt61
  Alibaba (Taobao, 1688.com)
opt61
7
opt44
  Amazon
opt44
8
opt10
  AOL
opt10
9
opt131
  Apple
opt131
10
opt143
  autocosmos.com
opt143
11
opt59
  Avito
opt59
12
opt56
  Badoo
opt56
13
opt209
  BANDUS
opt209
14
opt138
  Bazos.sk
opt138
15
opt187
  Beget.com
opt187
16
opt17
  bet365
opt17
17
opt192
  Betano (+BETANO.ro)
opt192
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
opt226
  Cash App
opt226
30
opt214
  Cashrewards
opt214
31
opt201
  Casino Plus
opt201
32
opt176
  ChoTot
opt176
33
opt76
  CityMobil
opt76
34
opt196
  Claude (Anthropic)
opt196
35
opt98
  Clubhouse
opt98
36
opt112
  CoinBase
opt112
37
opt51
  CONTACT
opt51
38
opt26
  Craigslist
opt26
39
opt124
  Credit Karma
opt124
40
opt157
  CupidMedia
opt157
41
opt150
  Czech email services
opt150
42
opt53
  Deliveroo
opt53
43
opt204
  DenimApp
opt204
44
opt92
  DiDi
opt92
45
opt45
  Discord
opt45
46
opt232
  DistroKid
opt232
47
opt27
  Dodopizza + PapaJohns
opt27
48
opt40
  Doordash
opt40
49
opt32
  Drom.RU
opt32
50
opt31
  Drug Vokrug
opt31
51
opt136
  dundle
opt136
52
opt21
  EasyPay
opt21
53
opt200
  ENEBA
opt200
54
opt141
  EUROBET
opt141
55
opt2
  Facebook
opt2
56
opt43
  FastMail
opt43
57
opt215
  Fbet
opt215
58
opt159
  Feeld
opt159
59
opt6
  Fiverr
opt6
60
opt139
  fontbet
opt139
61
opt189
  foodora
opt189
62
opt115
  foodpanda
opt115
63
opt221
  Fortuna
opt221
64
opt13
  Fotostrana
opt13
65
opt142
  funpay
opt142
66
opt68
  G2A.COM
opt68
67
opt77
  Gameflip
opt77
68
opt28
  Gamers set (offgamers.com, G2A.com, seagm.com)
opt28
69
opt179
  GetsBet.ro
opt179
70
opt35
  GetTaxi
opt35
71
opt188
  GGbet
opt188
72
opt229
  GGPokerUK
opt229
73
opt85
  giocodigitale.it
opt85
74
opt108
  Glovo & Raketa
opt108
75
opt1
  Google (YouTube, Gmail)
opt1
76
opt140
  Google Voice
opt140
77
opt30
  GrabTaxi
opt30
78
opt420
  Grailed
opt420
79
opt110
  Grindr
opt110
80
opt155
  Happn
opt155
81
opt203
  HelloTalk
opt203
82
opt216
  Hey
opt216
83
opt120
  Hinge
opt120
84
opt144
  hopper
opt144
85
opt166
  HUAWEI
opt166
86
opt103
  ICard
opt103
87
opt165
  idealista.com
opt165
88
opt55
  ifood
opt55
89
opt111
  IMO
opt111
90
opt167
  inbox.lv
opt167
91
opt118
  Inboxdollars
opt118
92
opt16
  Instagram (+Threads)
opt16
93
opt193
  Ipsos
opt193
94
opt94
  JD.com
opt94
95
opt71
  KakaoTalk
opt71
96
opt175
  Klarna
opt175
97
opt152
  kleinanzeigen.de
opt152
98
opt99
  KoronaPay
opt99
99
opt129
  kwiff.com
opt129
100
opt195
  Lajumate.ro
opt195
101
opt180
  Lalamove
opt180
102
opt182
  LAPOSTE
opt182
103
opt222
  LASVEGAS.RO
opt222
104
opt60
  Lazada
opt60
105
opt164
  Leboncoin
opt164
106
opt37
  Line Messenger
opt37
107
opt8
  LinkedIn
opt8
108
opt42
  LiveScore
opt42
109
opt105
  LocalBitcoins
opt105
110
opt114
  Locanto.com
opt114
111
opt75
  Lyft
opt75
112
opt126
  Magnit
opt126
113
opt33
  Mail.RU
opt33
114
opt4
  Mail.ru Group
opt4
115
opt100
  Mamba
opt100
116
opt171
  Marktplaats
opt171
117
opt219
  maxline.by
opt219
118
opt96
  MiChat
opt96
119
opt15
  Microsoft (Azure, Bing, Skype, etc)
opt15
120
opt156
  mobileDE
opt156
121
opt184
  MOMO
opt184
122
opt121
  Monese
opt121
123
opt47
  MoneyLion
opt47
124
opt197
  MPSellers
opt197
125
opt211
  MrGreen
opt211
126
opt7
  MS Office 365
opt7
127
opt0
  myopinions & erewards
opt0
128
opt73
  Naver
opt73
129
opt198
  Nectar
opt198
130
opt95
  NetBet
opt95
131
opt116
  Neteller
opt116
132
opt101
  Netflix
opt101
133
opt202
  NHNCloud
opt202
134
opt177
  NHNcorp (강남언니)
opt177
135
opt119
  Nico
opt119
136
opt151
  novibet.com
opt151
137
opt5
  OD
opt5
138
opt113
  OfferUp
opt113
139
opt230
  OkCupid
opt230
140
opt228
  OKX
opt228
141
opt70
  OLX + goods.ru
opt70
142
opt19
  OTHER (no guarantee)
opt19
143
opt00019
  OTHER (voice code)
opt00019
144
opt212
  OurTime
opt212
145
opt181
  OZON.ru
opt181
146
opt109
  Paddy Power
opt109
147
opt169
  Pari.ru
opt169
148
opt3
  Parimatch
opt3
149
opt162
  Payoneer
opt162
150
opt83
  PayPal + Ebay
opt83
151
opt122
  Paysafecard
opt122
152
opt183
  PAYSEND
opt183
153
opt149
  pm.by
opt149
154
opt84
  POF.com
opt84
155
opt107
  Prom.UA
opt107
156
opt57
  Proton Mail
opt57
157
opt207
  Publi24
opt207
158
opt154
  Rambler.ru
opt154
159
opt133
  Revolut
opt133
160
opt153
  ROOMSTER
opt153
161
opt170
  Royal Canin
opt170
162
opt186
  RusDate
opt186
163
opt185
  Samokat
opt185
164
opt174
  Samsung
opt174
165
opt97
  SberMarket
opt97
166
opt134
  Schibsted-konto
opt134
167
opt48
  Shopee
opt48
168
opt127
  Signal
opt127
169
opt38
  Sisal
opt38
170
opt49
  Skout
opt49
171
opt117
  Skrill
opt117
172
opt90
  Snapchat
opt90
173
opt190
  SNKRDUNK
opt190
174
opt234
  Solitaire Cash
opt234
175
opt58
  Steam
opt58
176
opt146
  subito.it
opt146
177
opt125
  Swagbucks
opt125
178
opt82
  Tango
opt82
179
opt161
  TANK.RU
opt161
180
opt74
  Taxi Maksim
opt74
181
opt29
  Telegram
opt29
182
opt00029
  Telegram (voice code)
opt00029
183
opt34
  Tencent QQ
opt34
184
opt52
  Ticketmaster
opt52
185
opt104
  TikTok
opt104
186
opt9
  Tinder
opt9
187
opt235
  TLScontact
opt235
188
opt191
  TopCashback
opt191
189
opt220
  TOTOGAMING
opt220
190
opt218
  TransferGo
opt218
191
opt233
  TrueCaller
opt233
192
opt66
  Twilio
opt66
193
opt205
  Twitch
opt205
194
opt41
  Twitter
opt41
195
opt160
  U By Prodia
opt160
196
opt72
  Uber
opt72
197
opt39
  Verse
opt39
198
opt11
  Viber
opt11
199
opt130
  Vinted
opt130
200
opt69
  VK
opt69
201
opt178
  VonageVF
opt178
202
opt147
  VooV Meeting
opt147
203
opt213
  Waitomo
opt213
204
opt206
  WalletHub
opt206
205
opt227
  Walmart
opt227
206
opt172
  WEB.DE
opt172
207
opt24
  WebMoney&ENUM
opt24
208
opt67
  WeChat
opt67
209
opt54
  Weebly
opt54
210
opt80
  WESTSTEIN
opt80
211
opt231
  Whatnot
opt231
212
opt20
  WhatsAPP
opt20
213
opt00020
  WhatsAPP (voice code)
opt00020
214
opt123
  Whoosh
opt123
215
opt106
  Wing Money
opt106
216
opt91
  Wise
opt91
217
opt163
  Wolt
opt163
218
opt208
  WooPlus
opt208
219
opt173
  X World Wallet
opt173
220
opt65
  Yahoo
opt65
221
opt88
  Yalla.live
opt88
222
opt23
  Yandex&YooMoney
opt23
223
opt158
  Zalo
opt158
224
opt225
  Zasilkovna
opt225
225
opt93
  Zoho
opt93
226
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]