Using the Twilio Addon Lookup
Installation
Install the Twilio Scout Addon
Parameter Overview
Dialcode: e164 format
Curl Request
curl -XGET https://lookups.twilio.com/v1/PhoneNumbers/+16502530000/?AddOns=icehook_scout -u AC0xxxxxxxxxxxxx:[AuthToken]
Response Body
{
"dialcode_e164": "+16502530000",
"timezone": "America/Los_Angeles",
"timezone_short": "PDT",
"timezone_utc_offset": "-08:00",
"region": "West",
"sub_region": "Pacific",
"administrative_area_level_3": null,
"administrative_area_level_2": "San Francisco County",
"administrative_area_level_1": "California",
"administrative_area_level_1_short": "CA",
"locality": "San Francisco",
"sublocality_level_1": null,
"point_of_interest": null,
"neighborhood": null,
"clli": "SNFCCASY",
"switch_assignment_date": "2005-12-28T00:00:00.000Z",
"country": "United States",
"country_short": "US",
"postal_code": "94108",
"operating_company_name": "Twilio",
"operating_company_type": "clec",
"lata": "722",
"ocn": "8826",
"line_type": "voip",
"location_routing_number": "+14159686199",
"ported": true,
"risk_rating": "highly_likely",
"risk_level": 94,
"ported_date": null,
"dialcode_invalid": false,
"dialcode_impossible": false,
"notes": "Email us at support@icehook.com with any inquiries."
}
Response Attributes
Response Key |
|
Type |
|
Description |
dialcode_e164 |
|
string |
|
The requested dialcode after parsing and formatting in the E164 international standard. |
timezone |
|
string |
|
Time Zone in which the phone number's central office is located. |
timezone_short |
|
string |
|
Time Zone in which the phone number's central office is located. |
timezone_utc_offset |
|
string |
|
Time Zone UTC offset. |
region |
|
string |
|
Region of the country the number is orinally located. |
sub_region |
|
string |
|
A more granular location within the Region. |
administrative_area_level_3 |
|
string |
|
Third geographic adminstrative division where the local exchange associated with the phone number is located. |
administrative_area_level_2 |
|
string |
|
Second geographic adminstrative division where the local exchange associated with the phone number is located. |
administrative_area_level_1 |
|
string |
|
Two letter abbreviation of administrative_area_level_1 as defined by the United States Postal Service. |
administrative_area_level_1_short |
|
string |
|
First geographic adminstrative division where the local exchange associated with the phone number is located. |
locality |
|
string |
|
The locality where the local exchange associated with the phone number is located. Typically the city name. |
sublocality_level_1 |
|
string |
|
The sublocality where the local exchange associated with the phone number is located. Boro of Brooklyn, for example. |
point_of_interest |
|
string |
|
A point of interest in the area where the local exchange associated with the phone number is located. |
neighborhood |
|
string |
|
The neighborhood where the local exchange associated with the phone number is located. |
clli |
|
string |
|
CLLI code (sometimes referred to as COMMON LANGUAGE Location Identifier Code and often pronounced as silly) is a Common Language Information Services identifier used within the North American telecommunications industry to specify the where the local exchange associated with the phone number is located. |
switch_assignment_date |
|
string |
|
The date in which the switch initially went into service. |
country |
|
string |
|
Name of country where the local exchange associated with the phone number is located. |
country_short |
|
string |
|
Two letter country code (ISO 3166-1 alpha-2 format) where the local exchange associated with the phone number is located. |
postal_code |
|
string |
|
Postal code where the local exchange associated with the phone number is located. |
operating_company_name |
|
string |
|
The company that provides service for the phone number. |
operating_company_type |
|
string |
|
The type of operating company associated with the phone number. |
lata |
|
string |
|
Local Access and Transport Area (LATA) represents a geographical area of the United States. |
ocn |
|
string |
|
Operating Company Number (OCN) is a 4 character ID for North American phone companies. |
line_type |
|
string |
|
The type of phone service associted with the phone number. |
location_routing_number |
|
string |
|
If ported, a Location Routing Number (or LRN) is a unique number that uses the format of a telephone number, which represents the local exchange in which the phone number is located. |
risk_rating |
|
string |
|
The likelihood a number is associated with a robo-call. |
risk_level |
|
integer |
|
The likelihood a number is associated with a robo-call on a scale of 0 to 99. Note that an invalid number will return a risk_level of 0. |
ported |
|
boolean |
|
If null, status is unknown, true means ported, false means not ported. |
ported_date |
|
string |
|
The date the number was ported. |
dialcode_invalid |
|
boolean |
|
A number that matches the NANP format, but contains an NPA that does not exist |
dialcode_impossible |
|
boolean |
|
A number that does not match the NANP format. |
notes |
|
string |
|
Relevant messages sent in response. |
Possible Operating Company Types
Operating Company Types |
Description |
cap |
Competitive Access Provider |
clec |
Competitive Local Exchange Carrier |
ethx |
Ethernet Exchange Provider |
general |
Various miscellaneous cases |
ic |
Interexchange Carrier |
ico |
Independent Company |
ilec |
Incumbent Local Exchange Carrier |
intl |
International |
ipex |
Internet Protocol Enabled Services |
l reseller |
Local Reseller |
p reseller |
Personal Communication Services Reseller |
pcs |
Personal Communications Services |
rboc |
Regional Bell Operating Company |
ulec |
Unbundled Local Exchange Carrier |
unknown |
Unknown entity |
wireless |
Wireless Provider |
w reseller |
Wireless Reseller |
Robocall/SPAM Risk Ratings and Risk Levels
Risk Rating |
|
Risk Level |
|
Description |
invalid |
|
0 |
|
Not a valid or public phone number. |
highly_unlikely |
|
1-20 |
|
Very unlikely to be a robocaller and is likely owned by a retail consumer. |
unlikely |
|
21-40 |
|
Unlikely to be a robocaller but little is known. |
possible |
|
41-60 |
|
There is no direct evidence this is a robocaller but likely belongs to a commercial entity. |
likely |
|
61-80 |
|
This is a suspicious number but not enough solid evidence to indict. |
highly_likely |
|
81-99 |
|
This is a number that has been credibly witnessed robocalling or spamming. |