Skip to main content
curl --request GET \
  --url "https://api.trestleiq.com/3.1/caller_id?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": [
      "Real Estate"
    ]
  },
  "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"
    }
  ],
  "emails": "waidong.syrws@email.com",
  "error": {
    "name": "InternalError",
    "message": "Could not retrieve entire response"
  },
  "warnings": [
    "Missing Input"
  ]
}
GET
/
3.1
/
caller_id
curl --request GET \
  --url "https://api.trestleiq.com/3.1/caller_id?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": [
      "Real Estate"
    ]
  },
  "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"
    }
  ],
  "emails": "waidong.syrws@email.com",
  "error": {
    "name": "InternalError",
    "message": "Could not retrieve entire response"
  },
  "warnings": [
    "Missing Input"
  ]
}

​
Caller ID API 3.1

GET https://api.trestleiq.com/3.1/caller_id?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=Waidong Syrws
​
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: 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.
​
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[]
Current location associated with Person or Business in belongs_to array.
​
emails
string[]
The list of emails associated to the primary owner of the phone.
​
error
object(PartialError)
Error details in case of an error.
​
warnings
string[]
Warnings returned as part of the response, if applicable. The possible values include - Invalid Input, International number. Not authorized, or Missing Input.

​
Error Responses

​
400 Bad Request:

  • Indicates that the server cannot process the request due to client-side errors.

​
403

  • Invalid API Key: Indicates that the API key is either incorrect or has been deactivated.
  • API Key Missing: Indicates that your request did not include an API key.
  • API Key Expired: Indicates that the API key has expired.

​
429 Too Many Requests:

  • API Key has exceeded its rate limit.

​
500 Internal Server Error:

  • An unexpected error occurred on the server.