Retrieving CNAM Owner Details

Overview

Vonage's Number Insight Advanced API enables you to retrieve CNAM owner details for many United States phone numbers. This includes landline and cellular numbers for both consumers and businesses.

CNAM is an acronym which stands for Caller ID Name. US networks use it to display the calling party’s name alongside the phone number, to help users identify a caller.

The Number Insight Advanced API only provides CNAM details for US numbers: it cannot return this information for numbers in other countries.

Making the request

Passing cnam=true as an extra parameter in a call to the Advanced API looks up that number's CNAM.

The following example shows how you would request CNAM data using curl:

curl "https://api.nexmo.com/ni/advanced/json?api_key=VONAGE_API_KEY&api_secret=VONAGE_API_SECRET&number=14155550100&cnam=true"

Understanding the response

In the response returned by the Number Insight Advanced API, the following fields relate to CNAM:

  • caller_name: the owner name
  • caller_type: either business or consumer depending on the type of number
  • first_name and last_name: for consumer numbers only

Consumer example

Business example