Trestle Logo
Powered by Redocly

Caller Identification API

Caller Identification API identifies caller information, including the name, demographics, address, and email associated with it.

Caller ID API 3.1

URL Structure: https://api.trestleiq.com/3.1/caller_id?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.

(PhoneOwnerPerson (object or null)) or (PhoneOwnerBusiness (object or null))

The primary owner of the phone number.

Array of objects

A list of unique current locations associated with Person or Business in belongs_to array.

emails
Array of strings

The list of emails associated to the primary owner of 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.1/caller_id
Request samples 
curl --location --request GET '/https://api.trestleiq.com/3.1/caller_id?phone=2069735100&phone.country_hint=US&phone.name_hint=Waidong+Syrys&phone.postal_code_hint=98264'  
 --header 'x-api-key: [insert_api_key]'  
 --header 'Accept: application/json'
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,
  • "belongs_to": {
    },
  • "current_addresses": [
    ],
  • "emails": "waidong.syrws@email.com",
  • "error": {
    },
  • "warnings": "Missing Input"
}
➔ Next to Smart CNAM API