Menu

Expand
Rate 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.

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.
Loading Code Sample...
        
        
        Caller name with consumer type (paid)

        Caller Name Lookup

        Caller name with consumer type (paid)
        Rate this page:

        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.

        Loading Code Sample...
              
              
              

              Thank you for your feedback!

              Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

              Sending your feedback...
              🎉 Thank you for your feedback!
              Something went wrong. Please try again.

              Thanks for your feedback!

              thanks-feedback-gif