Numbers
get-number
Get detailed information about a response number you have leased.
PARAMETER |
DESCRIPTION |
REQUIRED |
number |
The virtual number to retrieve |
YES |
Example
curl https://api.transmitsms.com/get-number.json \
-u 2e24c1cbdd987221e165d543f34b84bf:secret \
-d number=61414000009
JSON RESPONSE
{
number: "61491570110",
next_charge: "2013-08-14",
auto_renew: true,
price: "29",
status: "active",
forward_url: "http://example.com/sms"
}
XML RESPONSE
61491570110
2013-08-14
true
active
29
http://example.com/sms
PHP Example
getNumber('6140000000');
if($result->error->code=='SUCCESS')
{
echo"This number is {$result->status} and valid up to {$result->next_charge}";
}
else
{
echo"Error: {$result->error->description}";
}
lease-number
Lease a dedicated virtual number.
PARAMETER |
DESCRIPTION |
REQUIRED |
number |
The virtual number to lease. Omit this field to be given a random number. Use get-numbers to find out which numbers are currently available. |
NO |
Example
lease a number and have all responses sent to your server
curl https://api.transmitsms.com/lease-number.json \
-u 2e24c1cbdd987221e165d543f34b84bf:secret \
-d number=61414000013 \
-d 'forward_url=https://example.com/sms-responses.php'
JSON RESPONSE
{
number: "61491570156",
next_charge: "2014-09-25",
auto_renew: true,
status: "active",
price: "29",
forward_url: "https://example.com/sms"
}
XML RESPONSE
61491570156
2014-09-25
true
active
29
https://example.com/sms
PHP Example
leaseNumber('6140000000');
if($result->error->code=='SUCCESS')
{
echo"This number is {$result->status} and valid up to {$result->next_charge}";
}
else
{
echo"Error: {$result->error->description}";
}
get-numbers
Get a list of numbers either leased by you or available to be leased.
PARAMETER |
DESCRIPTION |
REQUIRED |
filter |
Possible values are owned – retrieve your own response numbers (default) available – retrieve response numbers available for purchase |
NO |
page |
Page number, for pagination |
NO |
max |
Maximum results returned per page |
NO |
Example
get a list of numbers you have leased
curl https://api.transmitsms.com/get-numbers.json \
-u 2e24c1cbdd987221e165d543f34b84bf:secret
JSON RESPONSE
{
filter: "owned",
numbers_total: 1,
numbers: [
{
number: "61491570110",
next_charge: "2013-08-14",
auto_renew: true,
status: "active",
price: "29",
forward_url: "http://example.com/sms"
}
],
page: {
count: 1,
number: 1
}
}
XML RESPONSE
owned
1
61491570110
2013-08-14
true
active
29
http://example.com/sms
1
1
Example
get a list of numbers available for lease
curl https://api.transmitsms.com/get-numbers.json \
-u 2e24c1cbdd987221e165d543f34b84bf:secret \
-d filter=available
JSON RESPONSE
{
filter: "available",
numbers_total: 134,
numbers: [
{
number: "61491570156",
next_charge: null,
auto_renew: true,
status: "inactive",
forward_url: "http://example.com/sms"
}
],
page: {
count: 14,
number: 1
}
}
XML RESPONSE
available
134
61491570156
null
true
inactive
http://example.com/sms
14
1
PHP Example
getNumbers($offset,$limit);
if($result->error->code=='SUCCESS')
{
echo"There are {$result->numbers_total} numbers,
showing page {$result->page->number} of {$result->page->count}
";
foreach($result->numbersas$number){
echo"Number {$number->number} is {$number->status}
and valid up to {$number->next_charge}
";
}
}
else
{
echo"Error: {$result->error->description}";
}