Skip to main content
GET
/
3.2
/
phone
GET https://api.trestleiq.com/3.2/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": [
    {}
  ]
}

​
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.

​
Endpoint

GET https://api.trestleiq.com/3.2/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. If multiple names or addresses are associated with the phone in Trestle database, this postal code hint will be used to rank name/address higher. Example: 98264

​
Headers

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

​
Code Examples

curl --request GET \
  --url "https://api.trestleiq.com/3.2/phone?phone=2069735100" \
  --header "x-api-key: YOUR_API_KEY"
Postman payload 
{
  "method": "GET",
  "url": "https://api.trestleiq.com/3.2/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 - 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
​
carrier
string
The company that provides voice and/or data services for the phone number. Carriers are returned at the MVNO level.
​
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.

​
Example Response

{
  "id": "Phone.3dbb6fef-a2df-4b08-cfe3-bc7128b6f5b4",
  "phone_number": "2069735100",
  "is_valid": true,
  "country_calling_code": "1",
  "line_type": "NonFixedVOIP",
  "carrier": "Trestle Telco",
  "is_prepaid": false,
  "is_commercial": true,
  "belongs_to": {
    "name": "John Doe",
    "firstname": "John",
    "lastname": "Doe"
  },
  "current_addresses": [
    {
      "id": "Location.d1a40ed5-a70a-46f8-80a9-bb4ac27e3a01",
      "street_line_1": "100 Main St",
      "city": "Seattle",
      "state_code": "WA",
      "postal_code": "98101",
      "country_code": "US"
    }
  ]
}

​
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