Order Single Number - 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

My Phone Numbers

SIP Users/Endpoints

Register - Create

Register - List

Register - Update

Register - Remove

IP Endpoint - Create

IP Endpoint - List

IP Endpoint - Remove

Channel Groups

Account Information

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

Restricted Users

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

Order Single Number

This function will allow you to order a specific number.
Post/ Get Information
URL:
​https://apiv1.teleapi.net/dids/order?token=XXXXXXX​
Argument
Required
Type
Value Example
number
yes
string
3035551212
call_flow
no
int
126
fax
no
int
yes
channel_group
no
int
126
voicemail_inbox_id
no
int
155
cnam
no
string
enabled
sms_post_url
no
string
http://example.net
call_post_url
no
string
https://example.net
delivery_notification_url
no
string
https://example.net
call_flow - is the call flow created in the portal you create to tell the number how to route
fax - if set to yes, the number will be a fax number
channel_group - if you have a virtual PRI or channel group, pass the id number
voicemail_inbox_id - if you have a voicemail you want this number to default to, pass it here
cnam - if you want caller id name to be passed (extra charge) enable this here
sms_post_url - Set an SMS URL specific to a phone number. This will override the account-wide SMS URL
call_post_url - The HTTP/HTTPS URL to call to
delivery_notification_url - Set the DLR notification URL for a phone number
​
Simply send us a GET/POST to the above URL to get an API response with the specific number. 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/order?token=XXXX&number=3035551212&call_flow=33"
Copied!
Using PHP+CURL
1
<?php
2
​
3
$data = array("number" => "3035551212",
4
"call_flow" => "133"
5
);
6
​
7
$data = http_build_query($data);
8
​
9
$baseurl = "https://apiv1.teleapi.net/dids/order?token=XXXX&state=CA";
10
curl_setopt($ch, CURLOPT_POST, 1);
11
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
12
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
13
$retval = curl_exec($ch);
14
curl_close($ch);
15
​
16
$object = json_decode($retval);
17
print_r($object);
Copied!
PHP - file_get_contents
1
<?php
2
$data = array("number" => "3035551212",
3
"call_flow" => "133"
4
);
5
​
6
$data = http_build_query($data);
7
​
8
$url = "https://apiv1.teleapi.net/dids/order?token=XXXX&".$data;
9
$x = file_get_contents($url);
10
$object = json_decode($x);
11
print_r($object);
Copied!
Order Phone Number Response Code
Accepted Order
1
{
2
  "code":200,
3
  "status":"success",
4
  "data"
5
     {"id":"1137811",
6
      "user_id":"320",
7
      "call_flow_id":"287",
8
      "channel_group_id":null,
9
      "voicemail_inbox_id":null,
10
      "number":"7247482695",
11
      "country_code":"1",
12
      "npa":"724",
13
      "nxx":"748",
14
      "xxxx":"2695",
15
      "number_type":"local",
16
      "state":"PA",
17
      "ratecenter":"BLACKTOWN",
18
      "sms_enabled":"1",
19
      "cnam":"disabled"
20
   }
21
 }
Copied!
Failed Order
1
{
2
  "code": 400,
3
  "status": "error",
4
  "data":"Invalid did id"
5
}
Copied!

Order Phone Numbers - Previous

List Tollfree Numbers

Next - Order Phone Numbers

Search Vanity Tollfree

Last modified 1yr ago

Copy link

Contents

Post/ Get Information