Attention! Numbers of United Kindom are available now for activations. Choose "United Kindom" in the list of countries.

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.

Service list

opt0 - ICQ

opt1 - GMail, YTube

opt2 - Facebook

opt3 - BurgerKing

opt4 - VK

opt5 - OD

opt6 - Fiverr

opt7 - Office365

opt8 - LinkedIn

opt9 - Tinder

opt10 - AOL

opt11 - Viber

opt13 - Fotostrana

opt14 - The Insiders

opt15 - MS, Bing, HotMail

opt16 - Instagram

opt17 - MeetMe

opt18 - Qiwi

opt19 - OTHER

opt20 - WhatsAPP

opt21 - Tinkoff

opt22 - SEOsprint.net

opt23 - Yandex

opt24 - WebMoney

opt25 - Yandex Taxi

opt26 - Craigslist

opt27 - dodopizza.ru

opt28 - 1688.com

opt29 - Telegram

opt30 - GrabTaxi

opt31 - Drug Vokrug

opt32 - Drom.RU

opt33 - Mail.RU

opt34 - Tencent QQ

opt35 - GetTaxi

opt37 - Line Messenger

opt38 - Auto.RU

opt39 - like4u

opt40 - Zalo

opt41 - Twitter

opt51 - Sipnet.ru

opt52 - Ubank.ru

opt53 - Rambler

opt54 - Weebly

opt56 - Badoo

opt57 - Proton Mail

opt58 - Steam

opt59 - Avito

opt60 - Nimses

opt61 - TaoBao

opt64 - iTunes

opt65 - Yahoo

opt66 - Twilio

opt67 - WeChat

opt68 - Talk2

opt69 - Lukoil-Garant

opt70 - OLX

opt71 - KakaoTalk

opt72 - Uber

opt73 - Naver

opt74 - Taxi Maksim

opt75 - Lyft

opt77 - Carousell

opt78 - Primo Connect

opt80 - Holvi

opt81 - UpWork

opt82 - Worldcore

opt83 - Ebay

opt84 - GetResponse

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

ATTENTION! Are available numbers of Kazakhstan, Ukraine, UK and Malaysia. For receiving them is necessary for you set up a parameter "country" = "KZ", "UA", "UK", and "MY" resp.


Example


http://smspva.com/priemnik.php?
  metod=get_number
  &country=RU
  &service=opt4
  &id=1
  &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]