URL Endpoints

GetGeoLocationByIP_V4 Inputs

NameTypeDescription
IPAddressStringIP address to look up, for example, “209.85.173.104”
LicenseKeyStringYour license key to use the service.
Sign up for a free trial key at
https://www.serviceobjects.com/products/demographics-more/ip-address-validation

GetGeoLocationByIP_V4 Outputs

Name [1]TypeValuesDescription
CertaintyInt0 to 100Rating of how accurate the outputs are likely to be.
CityStringVariesThe city location of the IP address.
RegionStringVariesThe state location of the IP address.
CountryStringVariesThe country location of the IP address.
CountryISO3StringVariesThe 3-letter country abbreviation.
CountryISO2StringVariesThe 2-letter country abbreviation.
PostalCode*StringVariesThe US postal code of the IP address.
MetroCode*StringVariesThe numerical metropolitan code for the DMA of the IP address’ location.
DMA*StringVariesThe Designated Market Area for the location of the IP address.
StateFIPS*StringVariesThe state Federal Information Processing Standards code for the IP address. This code is used to uniquely identify states.
CountyFIPS*StringVariesThe County Federal Information Processing Standards code for the location of the IP address. This code is used to uniquely identify counties throughout the US.
LatitudeDoubleVariesThe latitude coordinate for the IP address.
LongitudeDoubleVariesThe longitude coordinate for the IP address.
IsProxyString“TRUE” or “FALSE”Indicates whether the IP address is a known proxy.
ProxyType [2]String“NONE”, “PRIVATE”, “PUBLIC”, “ANONYMOUS”, “SATELLITE”Indicates the type of proxy. Further description of proxy type can be found in the table below
PossibleMobileDeviceString“TRUE” or “FALSE”Indicates if the IP address is believed to be used by mobile devices.
ISPStringVariesThe ISP which assigns the IP address.
NetblockOwnerStringVariesThe network owner to which the IP address is allocated.
HostNamesStringVariesThe host name associated with the IP address. If more than one host name is found then the names will be returned a comma delimited list. Will return if no host names are found.
IPNoteCodesStringVariesDisplays additional notes about the IP that were found during the validation process. Returns zero or more numerical note codes in a comma-separated list.**
IPNotesStringVariesContains the note flag(s) that corresponds to the Notes Codes. Returns zero or more notes flags in a comma-separated list.**
DebugStringVaries
ErrorErrorVariesSee “Error Page“.

*Applies only to IP addresses located within the United States
**New codes and descriptions will be added as new features become available and the number of codes will increase in time.

References