#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:
| Response message |
Description |
| { |
|
| “activationId”: 123456, |
|
| “phoneNumber”: “79295******”, |
|
| “activationCost”: 7.50, |
|
| “currency”: 840, |
ISO 4217 Number |
| “countryCode”: “0”, |
|
| “canGetAnotherSms”: “1”, |
|
| “activationTime”: “2025-05-14 11:10:42”, |
|
| “activationOperator”: null |
|
| } |
|
#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 |