Overview
Telecom Lookup Tools

Search Vanity Tollfree

This function will allow you to search for vanity toll free numbers

Post/ Get Information

URL:

​https://apiv1.teleapi.net/dids/tollfree/vanity?token=XXXXXXX​

Argument

Required

Type

Example Value

search

yes

string

8**2**VOIP

Simply send us a GET/POST to the above URL to get an API response with the list of all available toll free numbers, just pass the search=844*voip as an example. Response codes are in the menu to the left.

shell
PHP+CURL
PHP+PLAIN
RESPONSE
shell

Shell/CURL

curl -v -X GET "https://apiv1.teleapi.net/dids/tollfree/vanity?token=XXXX&search=8**833****"
PHP+CURL

Using PHP+CURL

<?php
​
$vanity = urlencode("8**3**VOIP");
​
$baseurl = "https://apiv1.teleapi.net/dids/tollfree/vanity?token=XXXX&search=".$vanity;
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$retval = curl_exec($ch);
curl_close($ch);
​
$object = json_decode($retval);
print_r($object);
PHP+PLAIN

PHP - file_get_contents

<?php
$vanity = urlencode("8**3**VOIP");
​
$url = "https://apiv1.teleapi.net/dids/tollfree/vanity?token=XXXX&search=".$vanity;
$x = file_get_contents($url);
$object = json_decode($x);
print_r($object);
RESPONSE

Results Were Found

{
"code":200,
"status":"success",
"data":
[{"id":"624",
"user_id":null,
"number":"8445553388",
"npa":"844",
"nxx":"555",
"xxxx":"3388",
"number_status":"list",
"create_dt":null,
"modify_dt":null
},
{"id":"624",
"user_id":null,
"number":"8445553388",
"npa":"844",
"nxx":"555",
"xxxx":"3388",
"number_status":"list",
"create_dt":null,
"modify_dt":null
}
]}

No Results Found

{
"code":200,
"status":"success",
"data":[]
}