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
UA
  Ukraine
UA
4
DE
  Germany
DE
5
IT
  Italy
IT
6
KZ
  Kazakhstan
KZ
7
HT
  Haiti
HT
8
DO
  Dominicana
DO
9
RO
  Romania
RO
10
AR
  Argentina
AR
11
AT
  Austria
AT
12
BD
  Bangladesh
BD
13
BE
  Belgium
BE
14
BA
  Bos. and Herz.
BA
15
BR
  Brazil
BR
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
EG
  Egypt (Virtual)
EG
24
EE
  Estonia
EE
25
FI
  Finland
FI
26
FR
  France
FR
27
GH
  Ghana (Virtual)
GH
28
HK
  Hong Kong
HK
29
IN
  India
IN
30
ID
  Indonesia
ID
31
IQ
  Iraq
IQ
32
IE
  Ireland
IE
33
IL
  Israel
IL
34
KE
  Kenya
KE
35
KG
  Kyrgyzstan
KG
36
LA
  Laos
LA
37
LV
  Latvia
LV
38
LT
  Lithuania
LT
39
MY
  Malaysia
MY
40
MX
  Mexico
MX
41
MD
  Moldova
MD
42
MA
  Morocco
MA
43
NL
  Netherlands
NL
44
NZ
  New Zealand
NZ
45
NG
  Nigeria
NG
46
PK
  Pakistan (Virtual)
PK
47
PY
  Paraguay
PY
48
PH
  Philippines
PH
49
PL
  Poland
PL
50
PT
  Portugal
PT
51
RS
  Serbia
RS
52
SI
  Slovenia
SI
53
ZA
  South Africa
ZA
54
ES
  Spain
ES
55
SE
  Sweden
SE
56
TH
  Thailand
TH
57
TR
  Turkey
TR
58
US
  United States
US
59
UK
  Unt. Kingdom
UK
60
VN
  Vietnam
VN

Service list


Logo
Service
Code
1
opt22
  888casino
opt22
2
opt86
  Adidas & Nike
opt86
3
opt46
  Airbnb
opt46
4
opt61
  Alibaba (Taobao, 1688.com)
opt61
5
opt44
  Amazon
opt44
6
opt10
  AOL
opt10
7
opt131
  Apple
opt131
8
opt59
  Avito
opt59
9
opt56
  Badoo
opt56
10
opt25
  BetFair
opt25
11
opt78
  Blizzard
opt78
12
opt135
  blsspain-russia.com
opt135
13
opt81
  Bolt
opt81
14
opt85
  boomplay
opt85
15
opt137
  bwin
opt137
16
opt141
  BytePlus
opt141
17
opt89
  Careem
opt89
18
opt134
  cashi
opt134
19
opt76
  CityMobil
opt76
20
opt98
  Clubhouse
opt98
21
opt112
  CoinBase
opt112
22
opt51
  CONTACT
opt51
23
opt26
  Craigslist
opt26
24
opt124
  Credit Karma
opt124
25
opt53
  Deliveroo
opt53
26
opt92
  DiDi
opt92
27
opt45
  Discord
opt45
28
opt27
  Dodopizza + PapaJohns
opt27
29
opt40
  Doordash
opt40
30
opt32
  Drom.RU
opt32
31
opt31
  Drug Vokrug
opt31
32
opt136
  dundle
opt136
33
opt21
  EasyPay
opt21
34
opt138
  Eureka
opt138
35
opt2
  Facebook
opt2
36
opt43
  FastMail
opt43
37
opt6
  Fiverr
opt6
38
opt115
  foodpanda
opt115
39
opt13
  Fotostrana
opt13
40
opt68
  G2A.COM
opt68
41
opt77
  Gameflip
opt77
42
opt35
  GetTaxi
opt35
43
opt108
  Glovo | Raketa
opt108
44
opt1
  Google
opt1
45
opt140
  Google Voice
opt140
46
opt30
  GrabTaxi
opt30
47
opt420
  Grailed
opt420
48
opt110
  Grindr
opt110
49
opt120
  Hinge
opt120
50
opt103
  ICard
opt103
51
opt55
  ifood
opt55
52
opt111
  IMO
opt111
53
opt118
  Inboxdollars
opt118
54
opt16
  Instagram
opt16
55
opt94
  JD.com
opt94
56
opt71
  KakaoTalk
opt71
57
opt99
  KoronaPay
opt99
58
opt60
  Lazada
opt60
59
opt37
  Line Messenger
opt37
60
opt8
  LinkedIn
opt8
61
opt42
  LiveScore
opt42
62
opt105
  LocalBitcoins
opt105
63
opt114
  Locanto.com
opt114
64
opt75
  Lyft
opt75
65
opt126
  Magnit
opt126
66
opt33
  Mail.RU
opt33
67
opt4
  Mail.ru Group
opt4
68
opt100
  Mamba
opt100
69
opt96
  MiChat
opt96
70
opt121
  Monese
opt121
71
opt47
  MoneyLion
opt47
72
opt7
  MS Office 365
opt7
73
opt15
  MS, Bing, HotMail, Azure
opt15
74
opt0
  myopinions & erewards
opt0
75
opt73
  Naver
opt73
76
opt95
  NetBet
opt95
77
opt116
  Neteller
opt116
78
opt101
  Netflix
opt101
79
opt119
  Nico
opt119
80
opt5
  OD
opt5
81
opt113
  OfferUp
opt113
82
opt70
  OLX + goods.ru
opt70
83
opt19
  OTHER (no guarantee)
opt19
84
opt109
  Paddy Power
opt109
85
opt3
  Parimatch
opt3
86
opt83
  PayPal + Ebay
opt83
87
opt122
  Paysafecard
opt122
88
opt129
  Paytm
opt129
89
opt84
  POF.com
opt84
90
opt107
  Prom.UA
opt107
91
opt57
  Proton Mail
opt57
92
opt133
  Revolut
opt133
93
opt97
  SberMarket
opt97
94
opt139
  SEC
opt139
95
opt48
  Shopee
opt48
96
opt127
  Signal
opt127
97
opt38
  Sisal
opt38
98
opt49
  Skout
opt49
99
opt117
  Skrill
opt117
100
opt132
  SkyLikes
opt132
101
opt90
  Snapchat
opt90
102
opt58
  Steam
opt58
103
opt146
  subito.it
opt146
104
opt125
  Swagbucks
opt125
105
opt82
  Tango
opt82
106
opt74
  Taxi Maksim
opt74
107
opt29
  Telegram
opt29
108
opt34
  Tencent QQ
opt34
109
opt52
  Ticketmaster
opt52
110
opt104
  TikTok
opt104
111
opt9
  Tinder
opt9
112
opt66
  Twilio
opt66
113
opt41
  Twitter
opt41
114
opt72
  Uber
opt72
115
opt128
  Vbet
opt128
116
opt39
  Verse
opt39
117
opt17
  vfsvisaservicesrussia
opt17
118
opt11
  Viber
opt11
119
opt130
  Vinted
opt130
120
opt69
  VK
opt69
121
opt24
  WebMoney&ENUM
opt24
122
opt67
  WeChat
opt67
123
opt54
  Weebly
opt54
124
opt80
  WESTSTEIN
opt80
125
opt20
  WhatsAPP
opt20
126
opt123
  Whoosh
opt123
127
opt106
  Wing Money
opt106
128
opt91
  Wise
opt91
129
opt65
  Yahoo
opt65
130
opt88
  Yalla.live
opt88
131
opt23
  Yandex&YooMoney
opt23
132
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]