Reverse Phone API

Reverse Phone API offers comprehensive verification and enrichment of phone numbers. It includes phone validity, line type, carrier data, and all owners associated with the phone and their details, like demographics, current addresses, alternate phones, and email addresses.

Reverse Phone API 3.2

URL Structure: https://api.trestleiq.com/3.2/phone?phone=[insert_phone_number]

Request

query Parameters

phone required	string 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. See: ISO-3166 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

header Parameters

x-api-key

required

string

The API Key.

Example: {{apiKey}}

Responses

200

Successful reverse phone response.

Response Schema: application/json

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. `Landline` - Traditional wired phone line. `Mobile` - Wireless phone line. `FixedVOIP` - VOIP number connected to a physical address, such as Vonix or Comcast. `NonFixedVOIP` - VOIP number unconnected to a fixed physical address, such as Google Voice or Skype. `Premium` - Caller pays a premium for the call–e.g. 976 area code. `TollFree` - Callee pays for call. `Voicemail` - Voicemail-only service. `Other` - Line type is unclear or does not match current categories. Enum: "Landline" "Premium" "NonFixedVOIP" "Mobile" "FixedVOIP" "TollFree" "Other" "Voicemail"
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.
	Array of ReversePhoneOwnerPerson (object) or ReversePhoneOwnerBusiness (object) or null The owner(s) associated to the phone.
	object (PartialError)
warnings	Array of strings Warnings returned as part of the response, if applicable. The possible values include - `Invalid Input`, `International number. Not authorized`, or `Missing Input`.

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: Indicates that the server encountered an unexpected error.

get/3.2/phone

Request samples

curl --request GET \
  --url 'https://api.trestleiq.com/3.2/phone?phone=2069735100&phone.country_hint=US&phone.name_hint=Waidong Syrws&phone.postal_code_hint=98264' \
  --header 'accept: application/json' \
  --header 'x-api-key: {insert_api_key}'

Response samples

application/json

{"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,
"owners": [{"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"
},
"delivery_point": "SingleUnit",
"link_to_person_start_date": "2011-10-05"
}
],
"alternate_phones": [{"phone_number": "2069735100",
"line_type": "NonFixedVOIP"
}
],
"emails": "waidong.syrws@email.com"
}
],
"error": {"name": "InternalError",
"message": "Could not retrieve entire response"
},
"warnings": "Missing Input"
}

➔ Next to Caller Identification API