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.
curl -X GET "https://lookups.twilio.com/v2/PhoneNumbers/{PhoneNumber}?Fields=caller_name" \ -u
$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
Coverage and Limitations: Data is sourced by CNAM 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
The following additional properties are returned for a Caller Name request.
| Property | Description |
|---|---|
CallerName |
A string indicating the name of the owner of the phone number. If not available, this will be null. |
CallerType |
A string indicating whether this caller is a business or consumer. Possible values are BUSINESS and CONSUMER. If not available, this will be null. |
ErrorCode |
The error code, if any, associated with your request. |
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.
