List Tollfree Numbers - api

Search…

Overview

SDK

SMS

Delivery Notifications

MMS

Sending - Embedded

Sending - w/ URL

Order Phone Numbers

List Ratecenters

List Local Numbers

List Tollfree Numbers

Order Single Number

Search Vanity Tollfree

Tollfree Vanity Order

International Numbers

Call Detail Reports

Get Call Records

Get SMS Records

Billing Detail Summary

SIP Users/Endpoints

Register - Create

Register - List

Register - Update

Register - Remove

IP Endpoint - Create

IP Endpoint - List

IP Endpoint - Remove

Channel Groups

LNP / Portability

Get Specific Information

Check Number Portability

Check Number Portability - Bulk

Submit Signature

Request CSV List

Customer Features

Customer - Create

Customer - List

Customer - Enable Account

Customer - Disable Account

Customer - Show Rates

Customer - Add Funds

Customer - Update Account

Customer - Update Branding

Customer - Remove CSS

Customer - Remove Logo

Customer - Update Rates

Customer - Set Credit Line

Customer - Reset Password

Customer - Set Channel Limits

Reseller Features

Overview - Complex

Reseller - Create

Reseller - List

Reseller - Enable Account

Reseller - Disable Account

Reseller - Show Rates

Reseller - Add Funds

Reseller - Update Account

Reassign Number to Reseller/Customer

Reseller - Update Branding

Reseller - Remove CSS

Reseller - Remove Logo

Reseller - Update Rates

Reseller - Set Credit Line

Reseller - Reset Password

Reseller - Get Token

Reseller - Enable Offnet

Reseller - Set Channel Limits

Fax Features

List all Faxes for a #

Download Fax File

Delete Fax File

List all Emails on Fax #

Add an Email to Fax #

Remove an Email on a #

Voicemail Features

Create Voicemail Account

Get Voicemail Account

List all Voicemail Accounts

Update Voicemail Account

Remove Voicemail Account

Add Inbox Email

Remove Inbox Email

List Voicemails

Remove Voicemail

Offnet Provisioning

Verify Capability

List Offnet Numbers

Status of Submit

List Job Numbers

Telecom Lookup Tools

Ownership Lookup

911 Emergency

Create 911 Record

Lookup 911 Record

List 911 Records

Update 911 Record

Remove 911 Record

Validate 911 Record

Overview - Alert Groups

Create 911 Alert Group

List 911 Alert Groups

Lookup 911 Alert Group

Remove Alert Group

Assign # to 911 Alert Group

Unassign # 911 Alert Group

Add Notification to AG

Remove Notify from Alert Group

Special Hooks & Options

Client Libraries

Call Recordings

List Recordings

Get a Recording

Remove a Recording

Campaign Registry

Brand - Qualify

Brand - Order vetting

Brand - Import vetting

Brand - List vettings

Brand - Get feedback

Campaign - List

Campaign - Create

Campaign - Update

Campaign - Delete

Campaign - Assign numbers

Campaign - Remove numbers

Campaign - Get numbers

Campaign - Get operation status

Campaign - Get MNO metadata

Campaign - Get OSR attributes

Campaign - Get sharing status

Reseller - List

Reseller - Create

Reseller - Update

Reseller - Delete

Enum - Usecases

Enum - Verticals

Enum - Optional Attribute Names

Enum - Alternative Business ID Types

Enum - Brand Identity Statuses

Enum - Brand Relationship Types

Enum - Campaign Statuses

Enum - Entity types

Enum - External Vetting Providers

Enum - Vetting Status

Enum - Brand Statuses

Enum - Operation Statuses

Enum - Approved Public Companies

Enum - Stock Exchanges

Enum - Vetting Classes

Webhook - Set URL

Campaign Registry - TCR Registered

Submit Campaign

Get Assigned Numbers

FAQ

Powered By GitBook

List Tollfree Numbers

This function will allow you to list all available toll free numbers.
Post/ Get Information
URL:
​https://apiv1.teleapi.net/dids/list?token=XXXXXXX​
Argument
Required
Type
Field
type
yes
string
tollfree
Simply send us a GET/POST to the above URL to get an API response with the list of numbers, just pass type=tollfree. Response codes are in the menu to the left.
shell
PHP+CURL
PHP+PLAIN
RESPONSE
Shell/CURL
1
curl -v -X GET  "https://apiv1.teleapi.net/dids/list?token=XXXX&type=tollfree"
Copied!
Using PHP+CURL
1
<?php
2
​
3
$data = array("type" => "tollfree");
4
​
5
$data = http_build_query($data);
6
​
7
$baseurl = "https://apiv1.teleapi.net/dids/states?token=XXXX&state=CA";
8
curl_setopt($ch, CURLOPT_POST, 1);
9
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
10
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
11
$retval = curl_exec($ch);
12
curl_close($ch);
13
​
14
$object = json_decode($retval);
15
print_r($object);
Copied!
PHP - file_get_contents
1
<?php
2
$data = array("state" => "CA",
3
"ratecenter" => "LSAN DA01"
4
);
5
​
6
$data = http_build_query($data);
7
​
8
$url = "https://apiv1.teleapi.net/dids/states?token=XXXX&".$data;
9
$x = file_get_contents($url);
10
$object = json_decode($x);
11
print_r($object);
Copied!
Possible System Responses from List Numbers
Successful Number Listing
1
{
2
    "code": 200,
3
    "status": "success",
4
    "data": {
5
      "dids": [
6
        {
7
            "id": 222,
8
            "npa": 888,
9
            "nxx": 555,
10
            "xxxx": 5555,
11
            "number": 8885555555,
12
            "ratecenter": "tollfree",
13
            "state": "null",
14
            "setup_rate":"0.000000",
15
            "monthly_rate":"0.790000",
16
            "per_minute_rate":"0.02000"
17
        },
18
        {
19
            "id": 333,
20
            "npa": 888,
21
            "nxx": 555,
22
            "xxxx": 5554,
23
            "number": 8885555554,
24
            "ratecenter": "tollfree",
25
            "state": "null",
26
            "setup_rate":"0.000000",
27
            "monthly_rate":"0.790000",
28
            "per_minute_rate":"0.0200"
29
        }
30
    ]}
31
    "count": 2
32
}
Copied!
Sample Error
1
{
2
    "code": 400,
3
    "status": "error",
4
    "data": "Missing variable: token"
5
}
Copied!

Order Phone Numbers - Previous

List Local Numbers

Next - Order Phone Numbers

Order Single Number

Last modified 2yr ago

Copy link

Contents

Post/ Get Information