SMS Rooms — Virtual Numbers for SMS Verification

API Documentation

HomeAPI

POST and GET requests are supported.

Requests must have an API key as a parameter api_key

API request address: https://sms-rooms.com/stubs/handler_api.php

Get Number

Request:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country&ref=$ref&maxPrice=$maxPrice

Parameters:

$api_keyYour API key
$serviceService to order
$countryNumber country
$refAccount ID(optional)
$maxPriceMaximum price(optional)

Response:

ACCESS_NUMBER:$activationId:$phoneNumber

Example request:

https://sms-rooms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=187&maxPrice=5

Response::

ACCESS_NUMBER:2887:17744056708

Errors:

BAD_KEY - invalid API key
BAD_ACTION - incorrect action
BAD_SERVICE - incorrect service name
BAD_COUNTRY - incorrect country name
NO_BALANCE - insufficient balance
NO_NUMBERS - no available numbers

Check Activation Status

Request:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

Parameters:

$api_keyYour API key
$idActivation ID received in getNumber

Response:

STATUS_OK:'SMS code' or STATUS_WAIT_CODE

Errors:

BAD_KEY - invalid API key
BAD_ACTION - incorrect action
NO_ACTIVATION - activation ID does not exist

Check Balance

Request:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getBalance

Parameters:

$api_keyYour API key

Response:

ACCESS_BALANCE:'Account balance'

Errors:

BAD_KEY - invalid API key
BAD_ACTION - incorrect action

Change Activation Status

Request:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id

Parameters:

$api_keyYour API key
$idActivation ID
$statusStatus: 1-ready, 3-request again, 6-complete, 8-cancel

Response:

ACCESS_READY / ACCESS_ACTIVATION / ACCESS_CANCEL / ACCESS_RETRY_GET

Example request:

https://sms-rooms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=setStatus&status=3&id=2887

Response::

ACCESS_RETRY_GET

Errors:

BAD_KEY - invalid API key
BAD_ACTION - incorrect action
NO_ACTIVATION - activation ID does not exist
BAD_STATUS - incorrect status

Services List

Request:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getServicesList

Parameters:

$api_keyYour API key

Response:

{"code": "Service ID", "name": "Service name"}

Errors:

BAD_KEY - invalid API key
BAD_ACTION - incorrect action

Countries List

Request:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getCountries

Parameters:

$api_keyYour API key

Response:

{"id": "Country ID", "rus": "Name in Russian", "eng": "Name in English"}

Errors:

BAD_KEY - invalid API key
BAD_ACTION - incorrect action

Numbers Count

Request:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country

Parameters:

$api_keyYour API key
$countryNumber country

Response:

{"service_code": "numbers_count"}

Errors:

BAD_KEY - invalid API key
BAD_ACTION - incorrect action
BAD_COUNTRY - incorrect country name

Price List

Request:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

Parameters:

$api_keyYour API key
$serviceService to order(optional)
$countryNumber country(optional)

Response:

{"Country code": {"Service code": {"Price": Count}}}

Errors:

BAD_KEY - invalid API key
BAD_ACTION - incorrect action
BAD_COUNTRY - incorrect country name
BAD_SERVICE - incorrect service name