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

{
  "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": {
    "id": "Person.fffdcf06-0929-4b5a-9921-ee49b101ca84",
    "name": "Waidong L Syrws",
    "firstname": "Waidong",
    "middlename": "L",
    "lastname": "Syrws",
    "alternate_names": [
      "Sryws W L"
    ],
    "age_range": "25-29",
    "gender": null,
    "type": "Person",
    "link_to_phone_start_date": "2019-03-23",
    "industry": null
  },
  "current_addresses": [
    {
      "id": "Location.d1a40ed5-a70a-46f8-80a9-bb4ac27e3a01",
      "location_type": "Address",
      "street_line_1": "100 Syrws St",
      "street_line_2": "Ste 1",
      "city": "Lynden",
      "postal_code": "98264",
      "zip4": "98264-9999",
      "state_code": "WA",
      "country_code": "US",
      "lat_long": {
        "latitude": 0,
        "longitude": 0,
        "accuracy": "Neighborhood"
      },
      "is_active": true,
      "delivery_point": "SingleUnit",
      "link_to_person_start_date": "2011-10-05"
    }
  ],
  "historical_addresses": [
    {
      "id": "Location.d1a40ed5-a70a-46f8-80a9-bb4ac27e3a01",
      "location_type": "Address",
      "street_line_1": "100 Syrws St",
      "street_line_2": "Ste 1",
      "city": "Lynden",
      "postal_code": "98264",
      "zip4": "98264-9999",
      "state_code": "WA",
      "country_code": "US",
      "lat_long": {
        "latitude": 0,
        "longitude": 0,
        "accuracy": "Neighborhood"
      },
      "is_active": true,
      "delivery_point": "SingleUnit",
      "link_to_person_start_date": "2011-10-05",
      "link_to_person_end_date": null
    }
  ],
  "associated_people": [
    {
      "id": "Person.fffdcf06-0929-4b5a-9921-ee49b101ca84",
      "name": "Waidong L Syrws",
      "firstname": "Waidong",
      "middlename": "L",
      "lastname": "Syrws",
      "relation": "Household"
    }
  ],
  "alternate_phones": [
    {
      "id": "Phone.3dbb6fef-a2df-4b08-cfe3-bc7128b6f5b4",
      "phone_number": "2069735100",
      "line_type": "NonFixedVOIP"
    }
  ],
  "error": {
    "name": "InternalError",
    "message": "Could not retrieve entire response"
  },
  "warnings": "Missing Input"
}
GET
/
3.1
/
phone
curl --request GET \
  --url "https://api.trestleiq.com/3.1/phone?phone=2069735100" \
  --header "x-api-key: YOUR_API_KEY"

{
  "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": {
    "id": "Person.fffdcf06-0929-4b5a-9921-ee49b101ca84",
    "name": "Waidong L Syrws",
    "firstname": "Waidong",
    "middlename": "L",
    "lastname": "Syrws",
    "alternate_names": [
      "Sryws W L"
    ],
    "age_range": "25-29",
    "gender": null,
    "type": "Person",
    "link_to_phone_start_date": "2019-03-23",
    "industry": null
  },
  "current_addresses": [
    {
      "id": "Location.d1a40ed5-a70a-46f8-80a9-bb4ac27e3a01",
      "location_type": "Address",
      "street_line_1": "100 Syrws St",
      "street_line_2": "Ste 1",
      "city": "Lynden",
      "postal_code": "98264",
      "zip4": "98264-9999",
      "state_code": "WA",
      "country_code": "US",
      "lat_long": {
        "latitude": 0,
        "longitude": 0,
        "accuracy": "Neighborhood"
      },
      "is_active": true,
      "delivery_point": "SingleUnit",
      "link_to_person_start_date": "2011-10-05"
    }
  ],
  "historical_addresses": [
    {
      "id": "Location.d1a40ed5-a70a-46f8-80a9-bb4ac27e3a01",
      "location_type": "Address",
      "street_line_1": "100 Syrws St",
      "street_line_2": "Ste 1",
      "city": "Lynden",
      "postal_code": "98264",
      "zip4": "98264-9999",
      "state_code": "WA",
      "country_code": "US",
      "lat_long": {
        "latitude": 0,
        "longitude": 0,
        "accuracy": "Neighborhood"
      },
      "is_active": true,
      "delivery_point": "SingleUnit",
      "link_to_person_start_date": "2011-10-05",
      "link_to_person_end_date": null
    }
  ],
  "associated_people": [
    {
      "id": "Person.fffdcf06-0929-4b5a-9921-ee49b101ca84",
      "name": "Waidong L Syrws",
      "firstname": "Waidong",
      "middlename": "L",
      "lastname": "Syrws",
      "relation": "Household"
    }
  ],
  "alternate_phones": [
    {
      "id": "Phone.3dbb6fef-a2df-4b08-cfe3-bc7128b6f5b4",
      "phone_number": "2069735100",
      "line_type": "NonFixedVOIP"
    }
  ],
  "error": {
    "name": "InternalError",
    "message": "Could not retrieve entire response"
  },
  "warnings": "Missing Input"
}

​
Reverse Phone API 3.1

GET https://api.trestleiq.com/3.1/phone?phone=[insert_phone_number]

​
Query Parameters

​
phone
string
required
The phone number in E.164 or local format. The default country calling code is +1 (USA). Example: phone=2069735100
​
phone.country_hint
string <ISO-3166-2>
The ISO-3166 alpha-2 country code of the phone number. Example: phone.country_hint=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: phone.name_hint=John Doe
​
phone.postal_code_hint
string
The postal code of the subscriber address associated with the phone number. Example: phone.postal_code_hint=98264

​
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.
​
country_calling_code
string or null <E.164>
The country code of the phone number (E.164 format).
​
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. Carriers are returned at the MVNO level.
​
is_prepaid
boolean or null
True if the phone is associated with a prepaid account.
​
is_commercial
boolean or null
True if the phone number is registered to a business.
​
belongs_to
(PhoneOwnerPerson (object or null)) or (PhoneOwnerBusiness (object or null))
The primary owner of the phone number.
​
current_addresses
object[]
A list of unique current locations associated with Person or Business in belongs_to array.
​
historical_addresses
object[]
Returns a list of unique historical locations associated with the phone.
​
associated_people
object[]
TThe list of related and associated people to person or business in belongs_to array.
​
alternate_phones
object[]
The list of alternate phone numbers of the primary owner of the phone number.
​
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.