• Returns geographic location, proxy, host name and US region information for a given IP address.

URL Endpoints

GetGeoLocationByIP_V4 Inputs

Name Type Description
IPAddress String IP address to look up, for example, “209.85.173.104”
LicenseKey String Your license key to use the service.
Sign up for a free trial key at
https://www.serviceobjects.com/ip-address-validation/

GetGeoLocationByIP_V4 Outputs

Name [1] Type Values Description
Certainty Int 0 to 100 Rating of how accurate the outputs are likely to be.
City String Varies The city location of the IP address.
Region String Varies The state location of the IP address.
Country String Varies The country location of the IP address.
CountryISO3 String Varies The 3-letter country abbreviation.
CountryISO2 String Varies The 2-letter country abbreviation.
PostalCode* String Varies The US postal code of the IP address.
MetroCode* String Varies The numerical metropolitan code for the DMA of the IP address’ location.
DMA* String Varies The Designated Market Area for the location of the IP address.
StateFIPS* String Varies The state Federal Information Processing Standards code for the IP address. This code is used to uniquely identify states.
CountyFIPS* String Varies The County Federal Information Processing Standards code for the location of the IP address. This code is used to uniquely identify counties throughout the US.
Latitude Double Varies The latitude coordinate for the IP address.
Longitude Double Varies The longitude coordinate for the IP address.
IsProxy String “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
PossibleMobileDevice String “TRUE” or “FALSE” Indicates if the IP address is believed to be used by mobile devices.
ISP String Varies The ISP which assigns the IP address.
NetblockOwner String Varies The network owner to which the IP address is allocated.
HostNames String Varies The 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.
IPNoteCodes String Varies Displays additional notes about the IP that were found during the validation process. Returns zero or more numerical note codes in a comma-separated list.**
IPNotes String Varies Contains the note flag(s) that corresponds to the Notes Codes. Returns zero or more notes flags in a comma-separated list.**
Debug String Varies
Error Error Varies See “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