Skip to content

GET /stubs/handler_api.php?action=getRentNumber

Rent virtual number for receiving SMS

This request allows you to order a phone number for rent.

You might want to use this service when you need to receive SMS from multiple different sources (websites, applications, other mobile numbers) or when need to receive SMS from a single one on the same number, but over a longer time (for example over 7 days).

WARNING

Phone number should be activated by receiving SMS within 20 minutes after the order, otherwise the operation will be closed and refunded automatically.

INFO

Please note that some services are prohibited for use (and SMS from these services are not available), you can find the list of such services on the front page or in Public offer.

Security

Parameters

NameTypeDescription
action*string

Method name, in this case getRentNumber

Enum:getRentNumberDefault:getRentNumber
country*integer

Country ID (according to getRentServicesAndCountries response)

Default:0Example:1
timeinteger

Desired rental period in hours, which will be converted into days
with a rounding-up upon order (e.g. 2h - 1 day, 25h - 2 days)

Default:24

Responses

200

Successful getRentNumber response from the server: either issues
a number for rent with specified parameters or throws an exception.

Code Samples