Attention! A new batch of our devices v1.0 are available now! Hurry up!

Last modified at 2017/06/02

Running queries to API

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


http://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


http://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
KZ
  Kazakhstan
KZ
3
UA
  Ukraine
UA
4
EE
  Estonia
EE
5
FR
  France
FR
6
ID
  Indonesia
ID
7
IL
  Israel
IL
8
LV
  Latvia
LV
9
PY
  Paraguay
PY
10
PH
  Philippines
PH
11
PL
  Poland
PL
12
RO
  Romania
RO
13
UK
  United Kingdom
UK
14
VN
  Viet Nam
VN
15
US2
  USA Virtual SIM
US2
16
CN2
  China Virtual SIM
CN2

Service list


Logo
Service
Code
1
opt28
  1688.com
opt28
2
opt85
  Adidas
opt85
3
opt46
  Airbnb
opt46
4
opt10
  AOL
opt10
5
opt38
  Auto.RU
opt38
6
opt59
  Avito
opt59
7
opt56
  Badoo
opt56
8
opt88
  Beetalk
opt88
9
opt92
  Bigo Live
opt92
10
opt3
  BurgerKing
opt3
11
opt89
  Careem
opt89
12
opt26
  Craigslist
opt26
13
opt45
  Discord
opt45
14
opt27
  dodopizza.ru
opt27
15
opt32
  Drom.RU
opt32
16
opt31
  Drug Vokrug
opt31
17
opt83
  Ebay
opt83
18
opt2
  Facebook
opt2
19
opt43
  FastMail
opt43
20
opt6
  Fiverr
opt6
21
opt13
  Fotostrana
opt13
22
opt68
  G2A.COM
opt68
23
opt77
  Gameflip
opt77
24
opt84
  GetResponse
opt84
25
opt35
  GetTaxi
opt35
26
opt1
  GMail, YTube
opt1
27
opt30
  GrabTaxi
opt30
28
opt80
  Holvi
opt80
29
opt0
  ICQ
opt0
30
opt16
  Instagram
opt16
31
opt94
  JD.com
opt94
32
opt71
  KakaoTalk
opt71
33
opt95
  Kardi
opt95
34
opt39
  like4u
opt39
35
opt37
  Line Messenger
opt37
36
opt8
  LinkedIn
opt8
37
opt69
  Lukoil-Garant
opt69
38
opt75
  Lyft
opt75
39
opt33
  Mail.RU
opt33
40
opt100
  Mamba
opt100
41
opt17
  MeetMe
opt17
42
opt7
  MS Office 365
opt7
43
opt15
  MS, Bing, HotMail
opt15
44
opt73
  Naver
opt73
45
opt101
  Netflix
opt101
46
opt86
  Nike
opt86
47
opt60
  Nimses
opt60
48
opt5
  OD
opt5
49
opt70
  OLX
opt70
50
opt19
  OTHER
opt19
51
opt97
  Post Bank
opt97
52
opt57
  Proton Mail
opt57
53
opt99
  QIP
opt99
54
opt18
  Qiwi
opt18
55
opt53
  Rambler
opt53
56
opt42
  Rediffmail
opt42
57
opt22
  SEOsprint.net
opt22
58
opt51
  Sipnet.ru
opt51
59
opt90
  Snapchat
opt90
60
opt98
  Spotify
opt98
61
opt58
  Steam
opt58
62
opt78
  Steemit
opt78
63
opt61
  TaoBao
opt61
64
opt74
  Taxi Maksim
opt74
65
opt29
  Telegram
opt29
66
opt34
  Tencent QQ
opt34
67
opt14
  The Insiders
opt14
68
opt9
  Tinder
opt9
69
opt21
  Tinkoff
opt21
70
opt66
  Twilio
opt66
71
opt41
  Twitter
opt41
72
opt52
  Ubank.ru
opt52
73
opt72
  Uber
opt72
74
opt81
  UpWork
opt81
75
opt11
  Viber
opt11
76
opt4
  VK
opt4
77
opt24
  WebMoney
opt24
78
opt67
  WeChat
opt67
79
opt54
  Weebly
opt54
80
opt20
  WhatsAPP
opt20
81
opt91
  WOG
opt91
82
opt82
  Worldcore
opt82
83
opt65
  Yahoo
opt65
84
opt23
  Yandex
opt23
85
opt25
  Yandex Taxi
opt25
86
opt40
  Zalo
opt40
87
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


http://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 ka

Example


http://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 [DEPRECATED. Please use get_count_new method]

Request for the amount of free activations for a certain service


In this method the parameter of service_id is always active, where it can be a value from the following services. This parameter is optional for other services.


Example


http://smspva.com/priemnik.php?
  metod=get_count
  &service=opt4
  &apikey=DSWAFvdedrE4
  &service_id=vk


Result

Provides a JSON answer after successful execution:

{"response":"1","counts Vkontakte":"127"}


Parameter service_id

service_id parameter can take on the following values:

4game - 4GAME

gmail - GMail

fb - Facebook

spaces - Spaces.ru

vk - Вконтакте

ok - Одноклассники

mamba - Mamba

avito - Avito

viber - Viber

fotostrana - Фотострана

ms - MS, Live, Bing, Hotmail

instagram - Instagram

qiwi - Qiwi с отвязкой

others - Другое

whatsapp - WhatsAPP

webtransfer - Webtransfer

seosprint - SEOsprint.net

ya - Яндекс

webmoney - WebMoney

nasimke - NaSimke.ru

com - COM.NU

dodopizza - Dodopizza.ru

tabor - Tabor.ru

telegram - Telegram

prostock - Простоквашино

drugvokrug - Друг Вокруг

drom - Drom.RU

mail - Mail.RU

twitter - Twitter


Errors codes

Error may occur while executing:

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

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.


Пример


http://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_number

Request for receiving a phone number for a certain service

Example


http://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


http://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


http://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'}


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:


        http://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


http://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_proverka

Checking the numbers for multiple SMS


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


Example


http://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


http://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 redirect

Number forwarding


This method works only for avito+forwarding service..


Example


http://smspva.com/priemnik.php?
  metod=redirect
  &service=opt59
  &id=25623
  &number_redirect=9869788422
  &apikey=DSWAFvdedrE4


Result

Provides a JSON answer after successful execution:

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


Note

Indicate the number for forwarding in the parameter number_redirect!


Errors codes

Error may occur while executing:

1) {"responce":2,"forwarding":"non_ok"} - Redirecting fail

2) {"responce":3,"forwarding":"wrong_number_format"} - Invalid number format for redirecting

3) {"responce":4,"forwarding":"unknown_error"} - Unknown error

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

How to redirect by API:

1) Order a number, line example


http://smspva.com/priemnik.php?
  metod=get_number
  &country=ru
  &service=opt59
  &id=1
  &apikey=DSWAFvdedrE4


2) Receive a SMS, line example

http://smspva.com/priemnik.php?
  metod=get_sms
  &country=ru
  &service=opt59
  &id=25623
  &apikey=DSWAFvdedrE4
  &sms=sms


3) After you've received the SMS, redirect, line example

http://smspva.com/priemnik.php?
metod=redirect
&service=opt59
&id=25623
&number_redirect=9869788422
&apikey=DSWAFvdedrE4

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 - http://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 - http://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 -http://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 -http://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 - http://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]