API

API is the protocol of interaction between your software and our activation server.

The API is necessary to automate the process of receiving SMS messages on your end.

To work with the API, you need to use your API key:

Log in to your account to obtain it!

Protocol description:

All requests should be sent to https://smsak.org/api/

All requests must include a mandatory parameter - the API key.

https://smsak.org/api/numbersstatus/$api_key?code=$code
$api_key - API key
$code - Country code
The service response will be in JSON format, example:
[{"id":"2","name":"Вконтакте","count":"108","logo":"/uploads/logo/vk.png","cost":"15"},{"id":"3","name":"Odnoklassniki","count":"6","logo":"/uploads/logo/ok.png","cost":"6"},{"id":"4","name":"Avito","count":"127","logo":"/uploads/logo/av.png","cost":"5"},{"id":"5","name":"viber","count":"127","logo":"/uploads/logo/vi.png","cost":"3"},{"id":"6","name":"telegram","count":"126","logo":"/uploads/logo/te.png","cost":"3"},{"id":"7","name":"whatsapp","count":"126","logo":"/uploads/logo/wh.png","cost":"1"},{"id":"8","name":"WeChat","count":"126","logo":"/uploads/logo/wc.png","cost":"6"},{"id":"9","name":"Google,Youtube,Gmail","count":"124","logo":"/uploads/logo/go.png","cost":"5"},{"id":"10","name":"youla.io","count":"126","logo":"/uploads/logo/yu.png","cost":"2"},{"id":"11","name":"Yahoo","count":"125","logo":"/uploads/logo/yo.png","cost":"2"},{"id":"12","name":"Microsoft","count":"125","logo":"/uploads/logo/mi.png","cost":"1"},{"id":"13","name":"facebook","count":"125","logo":"/uploads/logo/fb.png","cost":"1"},{"id":"14","name":"Rambler.ru","count":"126","logo":"/uploads/logo/ra.png","cost":"1"},{"id":"15","name":"yandex","count":"123","logo":"/uploads/logo/ya.png","cost":"5"},{"id":"16","name":"instagram","count":"125","logo":"/uploads/logo/in.png","cost":"4"},{"id":"17","name":"drugvokrug.ru","count":"124","logo":"/uploads/logo/we0.png","cost":"1"},{"id":"18","name":"mamba.ru","count":"125","logo":"/uploads/logo/78.jpg","cost":"1"},{"id":"19","name":"Qiwi","count":"125","logo":"/uploads/logo/qi.png","cost":"3"},{"id":"20","name":"WebMoney","count":"126","logo":"/uploads/logo/webmoney.png","cost":"5"},{"id":"21","name":"fotostrana.ru","count":"126","logo":"/uploads/logo/fotostrana.png","cost":"1"},{"id":"22","name":"ICQ","count":"126","logo":"/uploads/logo/ic.png","cost":"1"},{"id":"23","name":"Twitter","count":"127","logo":"/uploads/logo/tw.png","cost":"2"},{"id":"24","name":"Mail.ru","count":"126","logo":"/uploads/logo/ma.png","cost":"1"},{"id":"25","name":"Uber","count":"126","logo":"/uploads/logo/ub.png","cost":"3"}]

https://smsak.org/api/getbalance/$api_key
$api_key - API key
Service response, example:
500

https://smsak.org/api/getnumber/$api_key?id=$service&code=$code
$api_key - API key
$service - Service ID for ordering
$code - Country code
The service response will be in JSON format, example:
{"id":707,"number":"+79777777777","send":0}

https://smsak.org/api/countries/$api_key
$api_key - API key
The service response will be in JSON format, example:
[{"name":"Россия","code":"RU"},{"name":"Украина","code":"UA"},{"name":"Казахстан","code":"KZ"},{"name":"Узбекистан","code":"UZ"},{"name":"Швеция","code":"SE"},{"name":"Белоруссия","code":"BL"},{"name":"Великобритания","code":"GB"},{"name":"Молдова","code":"MD"},{"name":"Индонезия","code":"ID"},{"name":"Эстония","code":"EE"}]

https://smsak.org/api/getservices/$api_key
$api_key - API key
The service response will be in JSON format, example:
[{"id":3,"name":"Odnoklassniki","logo":"/uploads/logo/ok.png","cost":6},{"id":2,"name":"Вконтакте","logo":"/uploads/logo/vk.png","cost":15},{"id":4,"name":"Avito","logo":"/uploads/logo/av.png","cost":5},{"id":5,"name":"viber","logo":"/uploads/logo/vi.png","cost":3},{"id":6,"name":"telegram","logo":"/uploads/logo/te.png","cost":3},{"id":7,"name":"whatsapp","logo":"/uploads/logo/wh.png","cost":1},{"id":8,"name":"WeChat","logo":"/uploads/logo/wc.png","cost":6},{"id":9,"name":"Google,Youtube,Gmail","logo":"/uploads/logo/go.png","cost":5},{"id":10,"name":"youla.io","logo":"/uploads/logo/yu.png","cost":2},{"id":11,"name":"Yahoo","logo":"/uploads/logo/yo.png","cost":2},{"id":12,"name":"Microsoft","logo":"/uploads/logo/mi.png","cost":1},{"id":13,"name":"facebook","logo":"/uploads/logo/fb.png","cost":1},{"id":14,"name":"Rambler.ru","logo":"/uploads/logo/ra.png","cost":1},{"id":15,"name":"yandex","logo":"/uploads/logo/ya.png","cost":5},{"id":16,"name":"instagram","logo":"/uploads/logo/in.png","cost":4},{"id":17,"name":"drugvokrug.ru","logo":"/uploads/logo/we0.png","cost":1},{"id":18,"name":"mamba.ru","logo":"/uploads/logo/78.jpg","cost":1},{"id":19,"name":"Qiwi","logo":"/uploads/logo/qi.png","cost":3},{"id":20,"name":"WebMoney","logo":"/uploads/logo/webmoney.png","cost":5},{"id":21,"name":"fotostrana.ru","logo":"/uploads/logo/fotostrana.png","cost":1},{"id":22,"name":"ICQ","logo":"/uploads/logo/ic.png","cost":1},{"id":23,"name":"Twitter","logo":"/uploads/logo/tw.png","cost":2},{"id":24,"name":"Mail.ru","logo":"/uploads/logo/ma.png","cost":1},{"id":25,"name":"Uber","logo":"/uploads/logo/ub.png","cost":3}]

https://smsak.org/api/getstatus/$api_key?id=$id
$api_key - API key
$id - Activation ID
The service response will be in JSON format, example:
{"number":"+79777777777","from":"VKcom","text":"VK: 93401 - ваш код для регистрации ВКонтакте.","small":"93401","time":"2017-08-06 12:47:29"}

https://smsak.org/api/all-sms/$api_key?id=$id
$api_key - API key
$id - Activation ID
The service response will be in JSON format, example:
[{"number":"+79777777777","from":"VKcom","text":"509752 - код подтверждения регистрации","small":"509752","time":"2019-02-07 09:34:03"},{"number":"+79777777777","from":"VKcom","text":"VK: 93401 - ваш код для регистрации ВКонтакте.","small":"93401","time":"2017-08-06 12:47:29"}]

https://smsak.org/api/getlatestcode/$api_key?id=$id
$api_key - API key
$id - Activation ID
Service response, example:
94983

https://smsak.org/api/play/$api_key?id=$id
$api_key - API key
$id - Activation ID
Service response, example:
1

https://smsak.org/api/setstatus/$api_key?id=$id&status=$status
$api_key - API key
$id - Activation ID
$status - Activation status
$status = 1 - Return the number (if no message has been received on the number, the money for the number will be refunded))
$status = 2 - Set the number for call forwarding (Only for services with call forwarding). You need to specify the number in the $forward variable (&forward=79007777777)
Call forwarding can be set ONLY after receiving the first SMS
Service response, in case of a successful status change:
1
Service response, in case of an error:
{"error":"Возврат возможен не ранее чем через 30 секунд после взятия"}

{"name":"error","message":"Api ключ не действителен","code":202,"status":200,"type":"app\helpers\apiException"}
name - Always has the value "error" when an error occurs
message - Error description
code - Error code
status - Status (HTTP code), always has the value "200"
Possible error codes:
101 - 'Service not found'
102 - 'Insufficient funds'
103 - 'No numbers available'
201 - 'API key is missing'
202 - 'Api key is not valid'
203 - 'User blocked: Reason'

API for renting numbers

https://smsak.org/api/getfullnumbers/$api_key
$api_key - API key
The service response will be in JSON format, example:
{"RU":"10","UA":"5","KZ":"8"}

https://smsak.org/api/getfullnumber/$api_key?code=$code&tarif=$tarif
$api_key - API key
$code - country code
$tarif - tariff ID (determines the rental period)
The service response will be in JSON format, example:

https://smsak.org/api/getallfullnumbers/$api_key
$api_key - API key
The service response will be in JSON format, example:
[{"id":19999999,"time":"2012-10-14 20:48:12","number":"+3809999999999", "is_work":0}]
id - ID of the rented number
time - Date until which the number is rented
number - Number in international format
is_work - Number status (1 - online, 0 - offline)

https://smsak.org/api/send-enable-sim/$api_key?id=$id
$api_key - API key
$id - ID of the rented number
The service response will be in text format, example:
1
0 - Error
1 - Request to enable sent successfully
2 - The request has already been sent before, the number is in the process of being enabled in the network

https://smsak.org/api/send-disable-sim/$api_key?id=$id
$api_key - API key
$id - ID of the rented number
The service response will be in text format, example:
1
0 - Error
1 - Request to disable sent successfully

https://smsak.org/api/getallsmsofnumber/$api_key?phone=$phone
$api_key - API key
$phone - the rented phone number
The service response will be in JSON format, example:
[{"time":"2012-10-05 21:28:28","from":"Taxify","text":"9999 is your Taxify activation code.","number":"+380999999999"}]

https://smsak.org/api/getlastsmsofnumber/$api_key?phone=$phone&count=$count
$api_key - API key
$phone - the rented phone number
$count - number of the latest SMS
The service response will be in JSON format, example:
[{"time":"2012-10-05 21:28:28","from":"Taxify","text":"9999 is your Taxify activation code.","number":"+380999999999"}]

https://smsak.org/api/getalltarifs/$api_key
$api_key - API key
The service response will be in JSON format, example:
[{"id":1,"days":1,"cost":"150.00","country_id":1,"code":"RU"},{"id":2,"days":7,"cost":"400.00","country_id":1,"code":"RU"},{"id":14,"days":90,"cost":"3600.00","country_id":2,"code":"UA"},{"id":15,"days":90,"cost":"2700.00","country_id":3,"code":"KZ"},{"id":16,"days":180,"cost":"5400.00","country_id":1,"code":"RU"},{"id":17,"days":180,"cost":"5400.00","country_id":2,"code":"UA"},{"id":18,"days":180,"cost":"3600.00","country_id":3,"code":"KZ"}]

https://smsak.org/api/rebuynumber/$api_key?id=$id&tarif=$tarif
$api_key - API key
$id - ID of the rented number
$tarif - tariff ID (determines the rental period)
The service response will be in JSON format, example:

SMS-activate API

To emulate the SMS-activate API, you need to add the IP address of our server to the hosts file of your operating system for the SMS-activate domain, which is 135.125.0.45
Alternatively, you can also make direct requests through our website at https://smsak.org/stubs/handler_api.php
Some methods may have slight differences in implementation

https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country&operator=$operator
$api_key - API key
$country - country
The service response will be in JSON format. Example:
{"vk_0":154,"ok_0":155,"wa_0":241,"vi_0":102,"tg_0":80,"wb_0":92,"go_0":198,"av_0":118,"av_1":162,"fb_0":230}
Before the hyphen is the service name, and after the designation whether you need to enable redirection. 0 - no, 1 - yes.

https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getBalance
$api_key - API key
The service response will be in text format
ACCESS_BALANCE:'balance on the account'

https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&operator=$operator&ref=$ref&country=$country
$api_key - API key
$service - service for ordering
$operator - сmobile operator of the number
$ref - pass a referral identifier
The service response will be in text format
NO_NUMBERS - no numbers available
NO_BALANCE - balance exhausted
ACCESS_NUMBER:$id:$number , where ($id - operation ID, $number - phone number)

https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id
$api_key - API key
$id - ID of the rented number
$status - activation status (1: confirmation of number readiness (SMS sent to the number); 3: request another code (free); 6: complete activation)
The service response will be in text format:
ACCESS_READY - number readiness confirmed
ACCESS_RETRY_GET - waiting for a new SMS
ACCESS_ACTIVATION - service successfully activated
ACCESS_CANCEL - activation canceled

https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id
$api_key - API key
$id - Activation ID
The service response will be in text format:
STATUS_WAIT_CODE - waiting for SMS
STATUS_WAIT_RETRY:'previous, incorrect code' - waiting for code clarification
STATUS_CANCEL - activation canceled
STATUS_OK:'activation code' - code received

https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getFullSms&id=$id
$api_key - API key
$id - Activation ID
The service response will be in text format:
STATUS_WAIT_CODE - waiting for SMS
STATUS_CANCEL - activation canceled
FULL_SMS:full text received

https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country
$api_key - API key
$service - brief service name (optional)
$country - country code name (optional)
The service response will be in JSON format, example:
{"0":{"ot":{"count":0,"cost":5},"vk":{"count":0,"cost":19},"ok":{"count":26,"cost":3},"av":{"count":81,"cost":1}}

https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getCountries
$api_key - API key
The service response will be in JSON format, examp:
{"0":{"id":"0","rus":"Россия","visible":1,"retry":1,"rent":0,"multiService":0},"1":{"id":"1","rus":"Украина","visible":1,"retry":1,"rent":0,"multiService":0},"40":{"id":"40","rus":"Узбекистан","visible":1,"retry":1,"rent":0,"multiService":0},"16":{"id":"16","rus":"Великобритания","visible":1,"retry":1,"rent":0,"multiService":0},"6":{"id":"6","rus":"Индонезия","visible":1,"retry":1,"rent":0,"multiService":0},"34":{"id":"34","rus":"Эстония","visible":1,"retry":1,"rent":0,"multiService":0}}

Alternative way of working

Using your own software to transmit numbers and SMS (virtual SIMs, eSIMs, and other options) Instructions