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

{
  "400": {},
  "401": {},
  "403": {},
  "429": {},
  "500": {},
  "id": "<string>",
  "phone_number": "<string>",
  "is_valid": true,
  "country_calling_code": "<string>",
  "line_type": "<string>",
  "carrier": "<string>",
  "is_prepaid": true,
  "is_commercial": true,
  "belongs_to": {},
  "current_addresses": [
    {}
  ],
  "historical_addresses": [
    {}
  ],
  "associated_people": [
    {}
  ],
  "alternate_phones": [
    {}
  ]
}
This is an archived version of the API. Please use the Current Reverse Phone API for new integrations.

​
Overview

Reverse Phone API validates a phone number and provides phone metadata, owner name and demographics, current and historical addresses, relatives and associated people, and additional phone numbers. Version: 3.1 (Archived)

​
Endpoint

GET https://api.trestleiq.com/3.1/phone?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. If multiple names are associated with the phone in Trestle database, this name will be ranked higher. Example: John Doe
​
phone.postal_code_hint
string
The postal code of the subscriber address associated with the phone number. Example: 98264

​
Headers

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

​
Code Examples

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

​
Response

​
id
string
The persistent ID of the phone number. Format: Phone.<uuid>
​
phone_number
string
The phone number in E.164 or local format.
​
is_valid
boolean
True if the phone number is valid.
​
country_calling_code
string
The country code of the phone number (E.164 format).
​
line_type
string
The line type of the phone number. Possible values: Landline, Mobile, FixedVOIP, NonFixedVOIP, Premium, TollFree, Voicemail, Other.
​
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.
​
belongs_to
object
The primary owner of the phone number. Can be a Person or Business object.
​
current_addresses
array
A list of unique current locations associated with Person or Business.
​
historical_addresses
array
Returns a list of unique historical locations associated with the phone.
​
associated_people
array
The list of related and associated people to person or business.
​
alternate_phones
array
The list of alternate phone numbers of the primary owner.

​
Error Responses

​
400
object
Bad Request - Invalid parameters or input error
​
401
object
Unauthorized - Missing or invalid API key
​
403
object
Forbidden - API key not authorized or quota exceeded
​
429
object
Too Many Requests - Rate limit exceeded
​
500
object
Server Error - Internal server error