- Returns geographic location, proxy, host name and US region information for a given IP address.
URL Endpoints
- JSON:
- XML:
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.