Phone number id.
Complete undecorated phone number without extension or country code. Example: “2065551212”
If false, this is an invalid phone number. Reasons include invalid or missing area code, invalid country code, too short or too long number.
If true, indicates a valid phone number.
If null, current validity of this number is not known.
International country code (Spec: ITU-T E.164). Example: “1” for USA & Canada
Line type can be any of the following:
Landline: Traditional wired phone line
FixedVOIP: VOIP based fixed line phones
Mobile: Wireless phone line
Voicemail: Voicemail-only service
TollFree: Callee pays for call
Premium: Caller pays a premium for the call–e.g. 976 area code
NonFixedVOIP: Skype, for example
Other: Anything that does not match the previous categories
The company that provides voice and/or data services for this phone number. Example: “AT&T Wireless”
If true, phone number is associated to a prepaid phone account
If false, phone number is not associated with a prepaid phone account.
If null, the prepaid status of the phone is not known.
If true, phone number is associated to a business. Possible values are true, false, null.
Primary owner of the phone number. Person or Business. Firstname, middlenama, lastname, age_range, gender are available only for a Person entity.
Id of the Person or Business phone number belongs to.
Full name of the Person or Business phone number belongs to.
First name of the Person phone number belongs to. Always null for Business.
Middle name of the Person phone number belongs to. Always null for Business.
Last name of the Person phone number belongs to. Always null for Business.
Age range of the Person phone number belongs to. Always null for Business.
Possible returns include: 18-24, 25-29, 30-34, 35-39, 40-44, 45-49, 50-54, 55-59, 60-64, 65+.
Gender of the Person phone number belongs to. Always null for Business.
Possible returns include: Male, Female, null
Type of the entity phone number belongs to
Possible returns include: Person, Business.
String with ISO format date when phone got linked to person or business.
"street_line_1": "1301 5th Ave",
A list of unique current locations associated with Person or Business in belongs_to array.
Location id of the current address, person or business is associated with.
Part of “current_addresses” string indicating the type of address returned as associated with the phone owner. The most precise address information available will be provided with levels decreasing in precision in the following order: Address, ZipPlus4, CityPostalCode, PostalCode, City, State, Country.
"street_line_1": "1301 5th Ave"
Street line 1 of the current address, person or business is associated with. Value includes building number street name and secondary address
Street line 2 reserved. Always null
City of the current address, person or business is associated with.
Postal code of the current address, person or business is associated with.
zip4 of the current address, person or business is associated with.
2 digit state code of the current address, person or business is associated with.
Alpha-2 country code of the current address, person or business is associated with.
Latitude and longitude associated with the returned current address. Includes “accuracy” string that represents the accuracy of the latitude/longitude with levels decreasing in precision in the following order: RoofTop, Street, PostalCode, Neighborhood, City, State, Country.
It is possible for location_type and lat_long accuracy to have varying levels of precision. For example, the location_type may be “Address” while the lat_long provided is mapped only to the location of the “City” of the given address.
Indicates if the address is currently receiving mail. Possible values are true, false, or null.
Indicates delivery point for the address. Possible values:
String with ISO format date when address got linked to person or business.
|11||historical_addressesArray of objects|
A list of unique historical locations associated with Person in belongs_to array. Format is the same as current_addresses array object.
Business entities don’t support historical locations.
This response attribute is disabled by default and always returns empty array. Please reach out to us to enable it for your integration.
A list of related and associated people to person or business in belongs_to array.
Each object in the array will include:
Id of the associated person.
Full name of the associated person.
Relation of the associated person to phone owner.
Possible relation values include:
This will include an array of alternate phone numbers for people and businesses in belongs_to array.
An error message for a phone check. Following error objects may be returned here.
"message": "Could not retrieve entire response",
"message": "International Phone Number Lookup not authorized"
An array of strings with validation warnings. Possible values are
- Invalid Input
- Missing Input
- Invalid phone.county_hint value. Only Alpha-2 and Alpha-3 supported