Get Number V2
Reserves a number and returns a JSON payload with activation details.
GET http://privatesms.vip/stubs/handler_api.php?api_key={apikey}&action=getNumberV2&service={service}&country={country}&maxPrice={maxPrice}
Request Parameters
| Name | Description |
|---|
api_key | Personal API key from the client account. |
action | Must be getNumberV2. |
service | Service code from getServicesList. |
country | Country ID from getCountries. |
maxPrice | Optional maximum price filter. |
Response Examples
200 OK
{
"activationId": "9f6d4d1d-3096-49cf-a9ce-4ef6d58a8ef8",
"phoneNumber": "15551234567",
"activationCost": 0.24,
"countryCode": 186,
"canGetAnotherSms": "1",
"activationTime": "2026-04-06 10:30:00"
}
Error Responses
| Status | Server response | Description |
|---|
| 401 | BAD_KEY | The API key is invalid. |
| 400 | BAD_ACTION | The action value is invalid. |
| 500 | SERVER ERROR | Unexpected internal server error. |
| 403 | BANNED | The account is disabled. |
| 404 | BAD_SERVICE | Unknown service code. |
| 404 | BAD_COUNTRY | Unknown country ID. |
| 403 | NO_BALANCE | Account balance is too low for activation requests. |
| 409 | NO_NUMBERS | The service or country is valid, but there is no available number in the current pool. |
| 400 | BALANCE_MUST_BE_MORE_30 | Legacy compatibility response code. |