#Request a number V2
https://sms-online.pro/stubs/handler_api.php?action=getNumberV2&api_key=$api_key&country=$country&service=$service&ref=$ref&phoneException=$phoneException&maxPrice=$maxPrice
#Parameters:
| Parameters |
Type |
Required |
Description |
| $api_key |
string |
☑️ |
API key |
| $service |
string |
☑️ |
Service for ordering (see table) |
| $country |
integer |
☑️ |
country code (see table) |
| $ref |
string |
|
Transfer the referral ID |
| $phoneException |
string |
|
Excluding prefixes for phones numbers. Separate with commas. Record format: country code and 3 to 6 digits of the mask (e.g. 7918,7900111). The default value is the value specified in the profile. |
| $maxPrice |
float |
|
Maximum price for which you are ready to buy a number at Free Price. Float with dot separation (e.g. 10.55). If it is not specified, the purchase will take place at the regular price. |
#Response:
{
"activationId": 123456,
"phoneNumber": "79295******",
"activationCost": 7.50,
"currency": 840,
"countryCode": "0",
"canGetAnotherSms": "1",
"activationTime": "2025-05-14 11:10:42",
"activationOperator": null
}
| Response parameters |
Description |
| $activationId |
Order id |
| $phoneNumber |
Phone number |
| $activationCost |
Order price |
| $currency |
ISO 4217 Number |
| $countryCode |
Country code |
| $canGetAnotherSms |
Can get another sms |
| $activationTime |
Activation date |
| $activationOperator |
Mobile operator |
#Possible errors:
| Mistake |
Description |
| WRONG_MAX_PRICE:$min |
The specified maximum price is less than the allowed one |
| BAD_ACTION |
Incorrect action |
| BAD_SERVICE |
Incorrect service name |
| BAD_KEY |
Invalid API key |
| ERROR_SQL |
SQL-server error |
| BANNED |
Time for which the account is blocked |
| WRONG_EXCEPTION_PHONE |
Incorrect exclusion prefixes |
| NO_BALANCE_FORWARD |
Not enough funds to buy call forwarding |
| ORDER_ALREADY_EXISTS |
Order already created |