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

NameTypeDescription
PhoneNumberStringPhone number to look up, for example, “805-963-1700”
LicenseKeyStringYour license key to use the service.
Sign up for a free trial key at
https://www.serviceobjects.com/products/phone/geophone

GetPhoneInfo Outputs

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

References