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

{
  "id": "<string>",
  "phone_number": "<string>",
  "is_valid": true,
  "line_type": "<string>",
  "carrier": "<string>",
  "belongs_to": {},
  "current_addresses": [
    {}
  ]
}

​
Overview

The Caller Identification API provides an incoming caller’s identity, including phone metadata (carrier, line type, prepaid status, etc.), name, demographics, and current address.

​
Endpoint

GET https://api.trestleiq.com/3.0/caller_id?phone={phone}

​
Parameters

​
phone
string
required
The phone number in E.164 or local format. The default country calling code is +1 (USA). Example: 2069735100
​
phone.country_hint
string
The ISO-3166 alpha-2 country code of the phone number. Example: US
​
phone.name_hint
string
Person or Business name associated with the phone number.
​
phone.postal_code_hint
string
The postal code of the subscriber address associated with the phone number.

​
Headers

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

​
Code Examples

curl --request GET \
  --url "https://api.trestleiq.com/3.0/caller_id?phone=2069735100" \
  --header "x-api-key: YOUR_API_KEY"

​
Response

​
id
string
The persistent ID of the phone number.
​
phone_number
string
The phone number in E.164 or local format.
​
is_valid
boolean
True if the phone number is valid.
​
line_type
string
The line type of the phone number (Landline, Mobile, FixedVOIP, NonFixedVOIP, etc.).
​
carrier
string
The company that provides voice and/or data services for the phone number.
​
belongs_to
object
The primary owner of the phone number (Person or Business).
​
current_addresses
array
Current locations associated with the caller.