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

{
  "id": "<string>",
  "phone_number": "<string>",
  "is_valid": true,
  "activity_score": 123,
  "line_type": "<string>",
  "carrier": "<string>",
  "is_prepaid": true,
  "is_commercial": true
}

​
Overview

Trestle Phone Validation API validates the phone number and provides phone metadata, such as carrier name, line type (landline, mobile, non-fixed VoIP, etc.), and whether the phone is prepaid.

​
Endpoint

GET https://api.trestleiq.com/3.0/phone_intel?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.0/phone_intel?phone=2069735100" \
  --header "x-api-key: YOUR_API_KEY"
Postman payload 
{
  "method": "GET",
  "url": "https://api.trestleiq.com/3.0/phone_intel",
  "query": { "phone": "2069735100" },
  "headers": { "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.
​
activity_score
integer
Trestle’s activity scores range from 0 to 100. A score of 100 means consistent activity in the last 12 months, and a score of 0 means a disconnected number or no activity has been seen in the past year. - 70 or above: High confidence that the phone is connected and active - 30 or below: High confidence that the phone is disconnected or inactive - 50: Not enough signals to predict connection status
​
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.
​
is_prepaid
boolean
True if the phone is associated with a prepaid account.
​
is_commercial
boolean
True if the phone number is registered to a business.