Get Number
Reserves a number and returns activation ID and phone number in the classic text format.
GET http://privatesms.vip/stubs/handler_api.php?api_key={apikey}&action=getNumber&service={service}&country={country}&maxPrice={maxPrice}
Request Parameters
| Name | Description |
|---|
api_key | Personal API key from the client account. |
action | Must be getNumber. |
service | Service code from getServicesList. |
country | Country ID from getCountries. |
maxPrice | Optional maximum price filter. |
Response Examples
200 OK
ACCESS_NUMBER:9f6d4d1d-3096-49cf-a9ce-4ef6d58a8ef8:15551234567
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. |