Skip to main content
curl --request GET \
  --url "https://api.trestleiq.com/3.0/phone_intel?phone=2069735100" \
  --header "x-api-key: YOUR_API_KEY"

{
  "id": "Phone.3dbb6fef-a2df-4b08-cfe3-bc7128b6f5b4",
  "phone_number": "2069735100",
  "is_valid": true,
  "activity_score": 57,
  "country_calling_code": "1",
  "country_code": "US",
  "country_name": "United States",
  "line_type": "NonFixedVOIP",
  "carrier": "Level 3 Communications, LLC",
  "is_prepaid": false,
  "error": {
    "name": "InternalError",
    "message": "Could not retrieve entire response"
  },
  "warnings": "Missing Input"
}
GET
/
3.0
/
phone_intel
curl --request GET \
  --url "https://api.trestleiq.com/3.0/phone_intel?phone=2069735100" \
  --header "x-api-key: YOUR_API_KEY"

{
  "id": "Phone.3dbb6fef-a2df-4b08-cfe3-bc7128b6f5b4",
  "phone_number": "2069735100",
  "is_valid": true,
  "activity_score": 57,
  "country_calling_code": "1",
  "country_code": "US",
  "country_name": "United States",
  "line_type": "NonFixedVOIP",
  "carrier": "Level 3 Communications, LLC",
  "is_prepaid": false,
  "error": {
    "name": "InternalError",
    "message": "Could not retrieve entire response"
  },
  "warnings": "Missing Input"
}

​
Phone Validation API 3.0

GET https://api.trestleiq.com/3.0/phone_intel?phone=[insert_phone]

​
Query Parameters

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

​
Headers

​
x-api-key
string
required
Your API key for authentication. Example: {{apiKey}}

​
Response

​
id
string or null <Phone.<uuid>>
The persistent ID of the phone number.
​
phone_number
string or null (PhoneNumber)
The phone number in E.164 or local format. The default country calling code is +1 (USA).
​
is_valid
boolean or null
True if the phone number is valid.
​
activity_score
integer or null
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.An activity score of 70 or above means there is a high confidence that the phone is connected, assigned to a subscriber, and someone has been taking calls consistently. An activity score of 30 or below means there is a high confidence that the phone is either disconnected or no one will answer the call when the number is dialed in. An activity score of 50 means Trestle doesn’t have enough signals to predict whether the phone is connected or disconnected/inactive.If you want to filter leads based on the activity score, the following rules can be recommended:
  • Prioritize dialing good numbers with consistent activity: Scores 70 or above.
  • Weed out leads with disconnected/inactive numbers: Scores of 30 or below.
​
country_calling_code
string or null <E.164>
The country code of the phone number.
​
country_code
string or null <ISO-3166-2>
The ISO-3166 alpha-2 country code of the phone number. See: ISO-3166.
​
country_name
string or null
The country name of the location associated with the phone number.
​
line_type
string or null
The line type of the phone number. Possible values: - Landline - Traditional wired phone line - Mobile - Wireless phone line - FixedVOIP - VOIP number connected to a physical address - NonFixedVOIP - VOIP number unconnected to a fixed physical address - Premium - Caller pays a premium for the call - TollFree - Callee pays for call - Voicemail - Voicemail-only service - Other - Line type is unclear Enum: Landline Mobile FixedVOIP NonFixedVOIP Premium TollFree Voicemail Other
​
carrier
string or null
The company that provides voice and/or data services for the phone number.
​
is_prepaid
boolean or null
True if the phone is associated with a prepaid account.
​
error
object(PartialError)
Error details in case of an error.
​
warnings
string[]
Warnings returned as part of the response, if applicable. Possible values include: Invalid Input, International number. Not authorized, or Missing Input.

​
Error Responses

​
400

  • Invalid Parameters Error: Parameter called incorrectly.
  • Input Field Error: Incorrect parameter information, such as non-existent area code on a phone number.
  • Input Error: No parameters given.
  • Internal Error: If there is an internal error while performing the checks

​
401

  • Bad Request: If ’;’ used as parameter separator in request. Non-UTF-8-encoded request.
  • Not Authorized: No api_key parameter in the request.

​
403

  • Auth Error: API Key is not authorized for that request or expired.
  • Quota Exceeded Error: API Key has exceeded its quota.

​
429 Too Many Requests

  • API Key has exceeded its rate limit.

​
500 Internal Server Error

  • An unexpected error occurred on the server.