Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Line Type Intelligence


Lookup's Line Type Intelligence package allows you to get the line type of a phone number including mobile, landline, fixed VoIP, non-fixed VoIP, toll-free, and more.

To make a Line Type Intelligence request, add line_type_intelligence to the optional query parameter Fields when making a standard Lookup request.


_10
curl -X GET "https://lookups.twilio.com/v2/PhoneNumbers/{PhoneNumber}?Fields=line_type_intelligence" \ -u
_10
$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Coverage and Limitations: Worldwide support. Canada requires special approval, please read this support article(link takes you to an external page) to learn more. Querying a Canada phone number without access will return a 60601 error.

Release Stage and Access: Public Beta, available via self-service.


Response properties

response-properties page anchor

The following additional properties are returned for a Line Type Intelligence request.

NameDescription
MobileCountryCodeThe three digit mobile country code of the carrier, used with the mobile network code to identify a mobile network operator.
MobileNetworkCodeThe two-three digit mobile network code of the carrier, used with the mobile country code to identify a mobile network operator (only returned for mobile numbers).
CarrierNameThe name of the carrier; subject to change.
TypeThe phone number type. See Type property values for more information.
ErrorCodeThe error code, if any, associated with your request.

Type property values

type-property-values page anchor
(warning)

Warning

Carrier data is not available for phone number types: personal, tollFree, premium, sharedCost, uan, voicemail, pager, or unknown. In these cases MobileCountryCode, MobileNetworkCode, and CarrierName values will be null.

The following are the possible values for the Type property.

TypeDescription
landlineThe phone number is a landline number; generally not capable of receiving SMS messages.
mobileThe phone number is a mobile number; generally capable of receiving SMS messages.
fixedVoipA virtual phone number associated with a physical device (e.g., Comcast or Vonage).
nonFixedVoipA virtual phone number that can be obtained on the internet without the need for a physical device (e.g., Google Voice or Enflick).
personalA phone number designated for personal use.
tollFreeA toll-free phone number, which is one where calls are free for the calling party.
premiumA premium rate phone number, which typically charges higher than normal rates for special services.
sharedCostA shared cost phone number, which is one where the charge is partially paid by the calling party and charges higher than normal rates.
uanA universal access number, which is a national number which can route incoming calls to different destinations.
voicemailA phone number associated with a voicemail service.
pagerA phone number associated with a pager device.
unknownA valid phone number, but the line type could not be determined.

Line Type Intelligence Lookup

line-type-intelligence-lookup page anchor

Valid nonFixedVoip phone number (paid)

Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_14
// Download the helper library from https://www.twilio.com/docs/node/install
_14
import twilio from "twilio";
_14
_14
// Find your Account SID and Auth Token at twilio.com/console
_14
// and set the environment variables. See http://twil.io/secure
_14
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_14
const authToken = process.env.TWILIO_AUTH_TOKEN;
_14
const client = twilio(accountSid, authToken);
_14
_14
const phoneNumber = await client.lookups.v2
_14
.phoneNumbers("+14159929960")
_14
.fetch({ fields: "line_type_intelligence" });
_14
_14
console.log(phoneNumber.lineTypeIntelligence);

Output

_25
{
_25
"calling_country_code": "1",
_25
"country_code": "US",
_25
"phone_number": "+14159929960",
_25
"national_format": "(415) 992-9960",
_25
"valid": true,
_25
"validation_errors": null,
_25
"caller_name": null,
_25
"sim_swap": null,
_25
"call_forwarding": null,
_25
"line_status": null,
_25
"line_type_intelligence": {
_25
"error_code": null,
_25
"mobile_country_code": "240",
_25
"mobile_network_code": "38",
_25
"carrier_name": "Twilio - SMS/MMS-SVR",
_25
"type": "nonFixedVoip"
_25
},
_25
"identity_match": null,
_25
"reassigned_number": null,
_25
"sms_pumping_risk": null,
_25
"phone_number_quality_score": null,
_25
"pre_fill": null,
_25
"url": "https://lookups.twilio.com/v2/PhoneNumbers/+14159929960"
_25
}


The video below shows how to check a phone number's line type with Lookup using Node.js and the Twilio Node Helper Library.


Rate this page: