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
DO
  Dominicana
DO
8
RO
  Romania
RO
9
AL
  Albania
AL
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
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
EG
  Egypt (Virtual)
EG
25
EE
  Estonia
EE
26
FI
  Finland
FI
27
FR
  France
FR
28
GH
  Ghana (Virtual)
GH
29
GR
  Greece
GR
30
HK
  Hong Kong
HK
31
IN
  India
IN
32
ID
  Indonesia
ID
33
IQ
  Iraq
IQ
34
IE
  Ireland
IE
35
IL
  Israel
IL
36
KE
  Kenya
KE
37
KG
  Kyrgyzstan
KG
38
LA
  Laos
LA
39
LV
  Latvia
LV
40
LT
  Lithuania
LT
41
MK
  Macedonia
MK
42
MY
  Malaysia
MY
43
MX
  Mexico
MX
44
MD
  Moldova
MD
45
MA
  Morocco
MA
46
NL
  Netherlands
NL
47
NZ
  New Zealand
NZ
48
NG
  Nigeria
NG
49
PK
  Pakistan (Virtual)
PK
50
PY
  Paraguay
PY
51
PH
  Philippines
PH
52
PL
  Poland
PL
53
PT
  Portugal
PT
54
RS
  Serbia
RS
55
SI
  Slovenia
SI
56
ZA
  South Africa
ZA
57
ES
  Spain
ES
58
SE
  Sweden
SE
59
TH
  Thailand
TH
60
TR
  Turkey
TR
61
US
  United States
US
62
UK
  Unt. Kingdom
UK
63
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
opt59
  Avito
opt59
10
opt56
  Badoo
opt56
11
opt138
  Bazos.sk
opt138
12
opt17
  bet365
opt17
13
opt25
  BetFair
opt25
14
opt78
  Blizzard
opt78
15
opt135
  blsspain-russia.com
opt135
16
opt81
  Bolt
opt81
17
opt145
  bumble
opt145
18
opt137
  bwin
opt137
19
opt89
  Careem
opt89
20
opt148
  casa.it
opt148
21
opt76
  CityMobil
opt76
22
opt98
  Clubhouse
opt98
23
opt112
  CoinBase
opt112
24
opt51
  CONTACT
opt51
25
opt26
  Craigslist
opt26
26
opt124
  Credit Karma
opt124
27
opt53
  Deliveroo
opt53
28
opt92
  DiDi
opt92
29
opt45
  Discord
opt45
30
opt27
  Dodopizza + PapaJohns
opt27
31
opt40
  Doordash
opt40
32
opt32
  Drom.RU
opt32
33
opt31
  Drug Vokrug
opt31
34
opt136
  dundle
opt136
35
opt21
  EasyPay
opt21
36
opt141
  EUROBET
opt141
37
opt2
  Facebook
opt2
38
opt43
  FastMail
opt43
39
opt6
  Fiverr
opt6
40
opt139
  fontbet
opt139
41
opt115
  foodpanda
opt115
42
opt13
  Fotostrana
opt13
43
opt142
  funpay
opt142
44
opt68
  G2A.COM
opt68
45
opt77
  Gameflip
opt77
46
opt35
  GetTaxi
opt35
47
opt85
  giocodigitale.it
opt85
48
opt108
  Glovo | Raketa
opt108
49
opt128
  golgol
opt128
50
opt1
  Google (YouTube, Gmail)
opt1
51
opt140
  Google Voice
opt140
52
opt30
  GrabTaxi
opt30
53
opt420
  Grailed
opt420
54
opt110
  Grindr
opt110
55
opt120
  Hinge
opt120
56
opt144
  hopper
opt144
57
opt103
  ICard
opt103
58
opt55
  ifood
opt55
59
opt111
  IMO
opt111
60
opt118
  Inboxdollars
opt118
61
opt16
  Instagram
opt16
62
opt94
  JD.com
opt94
63
opt71
  KakaoTalk
opt71
64
opt99
  KoronaPay
opt99
65
opt129
  kwiff.com
opt129
66
opt60
  Lazada
opt60
67
opt37
  Line Messenger
opt37
68
opt8
  LinkedIn
opt8
69
opt42
  LiveScore
opt42
70
opt105
  LocalBitcoins
opt105
71
opt114
  Locanto.com
opt114
72
opt75
  Lyft
opt75
73
opt126
  Magnit
opt126
74
opt33
  Mail.RU
opt33
75
opt4
  Mail.ru Group
opt4
76
opt100
  Mamba
opt100
77
opt96
  MiChat
opt96
78
opt121
  Monese
opt121
79
opt47
  MoneyLion
opt47
80
opt7
  MS Office 365
opt7
81
opt15
  MS, Bing, HotMail, Azure
opt15
82
opt0
  myopinions & erewards
opt0
83
opt73
  Naver
opt73
84
opt95
  NetBet
opt95
85
opt116
  Neteller
opt116
86
opt101
  Netflix
opt101
87
opt119
  Nico
opt119
88
opt5
  OD
opt5
89
opt113
  OfferUp
opt113
90
opt143
  olimpbet.kz
opt143
91
opt70
  OLX + goods.ru
opt70
92
opt19
  OTHER (no guarantee)
opt19
93
opt00019
  OTHER (voice code)
opt00019
94
opt109
  Paddy Power
opt109
95
opt3
  Parimatch
opt3
96
opt83
  PayPal + Ebay
opt83
97
opt122
  Paysafecard
opt122
98
opt28
  plexbet.it
opt28
99
opt84
  POF.com
opt84
100
opt107
  Prom.UA
opt107
101
opt57
  Proton Mail
opt57
102
opt133
  Revolut
opt133
103
opt97
  SberMarket
opt97
104
opt134
  Schibsted-konto
opt134
105
opt48
  Shopee
opt48
106
opt127
  Signal
opt127
107
opt38
  Sisal
opt38
108
opt49
  Skout
opt49
109
opt117
  Skrill
opt117
110
opt90
  Snapchat
opt90
111
opt58
  Steam
opt58
112
opt146
  subito.it
opt146
113
opt125
  Swagbucks
opt125
114
opt82
  Tango
opt82
115
opt74
  Taxi Maksim
opt74
116
opt29
  Telegram
opt29
117
opt00029
  Telegram (voice code)
opt00029
118
opt34
  Tencent QQ
opt34
119
opt52
  Ticketmaster
opt52
120
opt104
  TikTok
opt104
121
opt9
  Tinder
opt9
122
opt66
  Twilio
opt66
123
opt41
  Twitter
opt41
124
opt72
  Uber
opt72
125
opt39
  Verse
opt39
126
opt11
  Viber
opt11
127
opt130
  Vinted
opt130
128
opt69
  VK
opt69
129
opt147
  VooV Meeting
opt147
130
opt24
  WebMoney&ENUM
opt24
131
opt67
  WeChat
opt67
132
opt54
  Weebly
opt54
133
opt80
  WESTSTEIN
opt80
134
opt20
  WhatsAPP
opt20
135
opt00020
  WhatsAPP (voice code)
opt00020
136
opt123
  Whoosh
opt123
137
opt106
  Wing Money
opt106
138
opt91
  Wise
opt91
139
opt65
  Yahoo
opt65
140
opt88
  Yalla.live
opt88
141
opt23
  Yandex&YooMoney
opt23
142
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]