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 access requires a total of at least $10 deposited to the account. The requirement is based on the cumulative amount deposited over the lifetime of the account, not on the current balance. Once the threshold is reached, access remains available regardless of how the balance changes. Requests below this threshold return NO_BALANCE:MIN_DEPOSIT_10.

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