Skip to main content
GET
/
3.1
/
cnam
GET https://api.trestleiq.com/3.1/cnam?phone={phone}

{
  "id": "<string>",
  "is_valid": true,
  "belongs_to": {},
  "error": {},
  "warnings": [
    {}
  ]
}

​
Overview

Smart CNAM API validates a phone number and provides person or business name associated to the phone. This is a lightweight API perfect for caller ID applications.

​
Endpoint

GET https://api.trestleiq.com/3.1/cnam?phone={phone}

​
Parameters

​
phone
string
required
The phone number in E.164 or local format. Example: 2069735100
​
phone.country_hint
string
The ISO-3166 alpha-2 country code of the phone number. Example: US

​
Headers

​
x-api-key
string
required
Your API key for authentication.

​
Code Examples

curl --request GET \
  --url "https://api.trestleiq.com/3.1/cnam?phone=2069735100&phone.country_hint=US" \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Accept: application/json"
Postman payload 
{
  "method": "GET",
  "url": "https://api.trestleiq.com/3.1/cnam",
  "query": { "phone": "2069735100", "phone.country_hint": "US" },
  "headers": {
    "x-api-key": "YOUR_API_KEY",
    "Accept": "application/json"
  }
}

​
Response

​
id
string
The persistent ID of the phone number.
​
is_valid
boolean
True if the phone number is valid.
​
belongs_to
object
The primary owner of the phone number with name information.
​
error
object
Error information if the request failed.
​
warnings
array
Warnings returned as part of the response, if applicable. Possible values include: Invalid Input, International number. Not authorized, or Missing Input.