This is the basic operation for finding the reverse-lookup information. Given a phone number, will consult national directory-assistance databases to find the owner and address registered. The addresses returned are not validated via any address-validation technique. They are returned to you exactly as the phone carrier releases them. If you need these addresses to be validated, using Service Objects’ AddressValidation web services is highly recommended. 
Both the contact’s information and the phone company’s information are returned with this operation. The other operations in this service return the same data, but pared down.
 
Two valuable bits of information are also retrieved – whether the phone line is for business or residential purposes, and whether the phone line is landline or wireless. By examining the WSDL, you may see that multiple groups of contact/exchange information are possible. Although they are possible in the XML, you will only see one exchange per output, always. It is common, however, to see multiple contacts per phone number (as people change numbers, or there may be multiple businesses at the same phone number.) It is highly recommended that you handle each of these contacts, rather than just the first contact returned.
 

URL Endpoints

GetPhoneInfo Inputs

Name Type Description
PhoneNumber String Phone number to look up, for example, “805-963-1700”
LicenseKey String Your license key to use the service.
Sign up for a free trial key at
https://www.serviceobjects.com/phone-insight/

GetPhoneInfo Outputs

Name Type Values Description
Name (Provider) String Varies The name of the line carrier of the phone number (“AT&T”).
City (Provider) String Varies The city location of the carrier’s exchange (“New York”).
State (Provider) String Varies The state location of the carrier’s exchange (“NY”).
LineType (Provider) String Landline / Wireless / Unknown The type of the phone line, can either be “Landline” or “Wireless”
Name (Contact) String Varies The name that the phone line is registered to. Can either be a person (“John Doe”) or a business (“Doe Corporation”).
Address (Contact) String Varies The street address to which the phone line is registered.
City (Contact) String Varies The city to which the phone line is registered.
State (Contact) String Varies The state to which the phone line is registered.
Zip (Contact) String Varies The zip code to which the phone line is registered.
Type (Contact) String Residential / Business / Unknown The type of entity that owns the phone line, will be either “Residential” or “Business”.
Error Error Varies See “Errors“.

References