This document defines the input, output and behavior of the web service operations in GeoPhone Plus. Currently there is only one.

Important Note!
Reverse-phone lookups are subject to federal rules determining who can procure data, and for what purpose. Currently, both disconnected and unlisted numbers return no contact information. GeoPhone Plus 2 returns contact information for connected landline phone numbers as well as wireless ones. Even in the cases that the phone number is disconnected or unlisted, GeoPhone Plus 2 will commonly return the exchange information. GeoPhone Plus 2 can provide information regarding Canadian phone numbers, although GeoPhone Plus 2 Canadian data is not as comprehensive as its US information. You should examine your own business needs first before exploring what GeoPhone Plus 2 can provide.

URL Endpoints

GetPhoneInfo Inputs

NameTypeDescription
PhoneNumber

String10 digit phone number

TestTypeString“FULL”, “BASIC” or “NORMAL”

LicenseKey

StringYour license key to use the service.
Sign up for a free trial key at
https://www.serviceobjects.com/products/phone/reverse
-phone-lookup-service

GetPhoneInfo Outputs

NameTypeDescription
PhoneInfo
PhoneInfo[]
Varies
The returned values of a valid phone
number.

ErrorObjectVariesThe returned error result from a failed
address verification or user input error.
NameTypeDescription
Providers

Provider

Varies

Contains the Provider object which contains information about the provider associated with the given phone number. This will only return 1 provider per phone number.

Contacts

Contacts[]VariesAn array of contacts associated with the phone number given. Can be zero to many contacts.
SMSAddress


StringVariesThe SMS Gateway Address for a wireless number.
MMSAddress

StringVariesThe MMS Gateway Address for a wireless number.
DateFirstSeen


StringVariesThis value represents the date the contact data was last updated.
DateOfPorting


StringVariesThis value represents the date a number was ported from one carrier to another.
NoteCodes


StringVariesThis value represents specific test result codes resulting from true statements about the test. See Descriptions Below.
NoteDescriptions


StringVariesThis value represents descriptions matching test codes returned during test.
TokensUsed


StringVariesThe number of tokens used in a given transaction. See Appendix A for details on tokens.
NameTypeDescription
Name


StringVariesThe name of the line carrier of the
phone number (“AT&T”).
City


StringVariesThe city location of the carrier’s
exchange (“New York”).
State


StringVariesThe state location of the carrier’s exchange (“NY”).
LineType [1]

StringLandline /
Wireless / VOIP / Unknown
The type of the phone line, can either be “Landline” “Wireless” “VOIP” or “Unknown”.
Latitude


StringVariesThe latitude of the phone exchange.
Longitude


StringVariesThe longitude of the phone exchange.
NameTypeDescription
Name


StringVariesThe name that the phone line is registered to. Can either be a person (“John Doe”) or a business (“Doe Corporation”).
Address








StringVariesThe street address to which the phone line is registered.
CityStringVariesThe city to which the phone line is registered.
StateStringVariesThe state to which the phone line is registered.
PostalCodeStringVariesThe zip code to which the phone line is registered.
PhoneTypeStringResidential/Government /Business /UnknownThe type of entity that owns the phone line, will be either “Residential”, “Business”, “Government” or “Unknown”.
LatitudeStringVariesThe latitude of the registered contact.
LongitudeStringVariesThe longitude of the registered contact.
SICCode







StringVariesThe 8 digit Standard Industrial Classification related to business contact.
SICDescStringVariesThe description of the 8 digit Standard Industrial Classification.
QualityScoreStringHIGH / MED / LOWLandlines contacts will return a score of HIGH. Wireless numbers will return a score of HIGH if CallerID match is found with contact name returned. If there is no CallerID match, but a contact is found a score of LOW is returned.

References

  1. Reverse Phone Lookup APIs – Differences Between GeoPhone & GeoPhone Plus