Buy Number

Allows you to purchase additional sms numbers for your company account. Each number has its own keywords, groups, and inbox. Local numbers can send 1 message per second. Toll Free numbers can send 3 messages per second. This API page should only be called after "Get Available Numbers", as you must choose from available numbers before attempting to buy one.

POST

https://www.titanly.net/api/sms/numbers/buyNumber.php

Post Variables:

Name	Status	Description
ApiKey	Required	Your company Api Key which can be found in the dashboard under account.
Number	Required	The number to buy. Make sure the number is available through Get Available Numbers.
Type	Required	Local number "1" or Toll Free number "2".

Base Example

PHP

<?php
	//Setup Variables
	$url = "https://www.titanly.net/api/sms/numbers/buyNumber.php";
	$fields['ApiKey'] = urlencode('Your API Key');
	$fields['Number'] = urlencode('The number (including country code)');
	$fields['Type'] = urlencode('1 [1=local, 2=toll free]');

	//Turn the $fields array into a POST string.
	$fieldString = '';
	foreach($fields as $key=>$value)
	{ 
		$fieldString .= $key.'='.$value.'&'; 
	}
	rtrim($fieldString, '&');

	// Use Curl To send the reqeust
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, count($fields));
	curl_setopt($ch, CURLOPT_POSTFIELDS, $fieldString);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
	curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
	$userData = curl_exec($ch);
	$info = curl_getinfo($ch);
	curl_close($ch);
?>

Base Payload

Payload

<Root>
	<response>success</response>
	<message> </message>
	<Data>
		<numberId>123</numberId>
	</Data>
</Root>