We created a new viewing experience for our SMS API documentation. It's now all in one central location. Click here to check it out!

This method allows you to purchase a new number. You can provide one of the numbers that you get using numbers.get or get random number from our list.


  • number - integer - optional number to lease



XML Request Example

<?xml version='1.0'?>










XML Response Example

<?xml version='1.0'?>




	<time>2012-11-08 15:51:44 GMT</time>

	<timestamp>1352389904 GMT</timestamp>



PHP Example


// change api key and secret to your own

$myAPIKey = "API_KEY";

$myAPISecret = "API_SECRET";

// include base class


// create new client object

$transmitsmsAPI = new transmitsmsAPI($myAPIKey, $myAPISecret);

// execute request

$methodResponse = $transmitsmsAPI->leaseNumber();

// parse response into xml object

$xml = @simplexml_load_string($methodResponse);


echo $xml->response.' number was leased';


echo $xml->error;


GET Example

Using a URL based request system you can request this method by using the below URL - be sure to url encode all your variables!