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

Caller Name

Lookup's Caller Name allows you to get information on the caller name and type for a mobile phone number.

Caller Name Lookups are billed per Lookup, even if data is not available. Currently, requesting a Caller Name Lookup for international numbers will return null values, but will not be billed.

To make a Caller Name request, add caller_name to the optional query parameter Fields when making a standard Lookup request.


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

Coverage and Limitations: Data is sourced by CNAM(link takes you to an external page) and is only available for phone numbers owned by carriers in the US.

Release Stage and Access: General access (GA), available via self-service.

Response properties

response-properties page anchor

The following additional properties are returned for a Caller Name request.

PropertyDescription
CallerNameA string indicating the name of the owner of the phone number. If not available, this will be null.
CallerTypeA string indicating whether this caller is a business or consumer. Possible values are BUSINESS and CONSUMER. If not available, this will be null.
ErrorCodeThe error code, if any, associated with your request.

Caller Name Lookup

caller-name-lookup page anchor

Caller name with consumer type (paid)

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

_10
// Download the helper library from https://www.twilio.com/docs/node/install
_10
// Find your Account SID and Auth Token at twilio.com/console
_10
// and set the environment variables. See http://twil.io/secure
_10
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10
const authToken = process.env.TWILIO_AUTH_TOKEN;
_10
const client = require('twilio')(accountSid, authToken);
_10
_10
client.lookups.v2.phoneNumbers('+14159929960')
_10
.fetch({fields: 'caller_name'})
_10
.then(phone_number => console.log(phone_number.callerName));

Output

_23
{
_23
"calling_country_code": "1",
_23
"country_code": "US",
_23
"phone_number": "+14159929960",
_23
"national_format": "(415) 992-9960",
_23
"valid": true,
_23
"validation_errors": null,
_23
"caller_name": {
_23
"caller_name": "Sergio Suarez",
_23
"caller_type": "CONSUMER",
_23
"error_code": null
_23
},
_23
"sim_swap": null,
_23
"call_forwarding": null,
_23
"line_status": null,
_23
"line_type_intelligence": null,
_23
"identity_match": null,
_23
"reassigned_number": null,
_23
"sms_pumping_risk": null,
_23
"phone_number_quality_score": null,
_23
"pre_fill": null,
_23
"url": "https://lookups.twilio.com/v2/PhoneNumbers/+14159929960"
_23
}

Rate this page: