Get the geo location data of the IP address.

GET {{baseUrl}}/v1/geo/:ip_address

What

Get the geo location data of the IP address passed as argument. This information includes: - Latitude and longitude - Time zone - Accuracy radius - Postal code - City name - Region - Country - Country of the service provider - Continent - Reverse PTR hostnames

Parameters

The only argument accepted in the query string is a public IPv4 or IPv6 addresses.

Result

The result contains the following set of data:

The result is a JSON object with the following structure: - self: the URI of the API call - accuracy_radius: The radius in kilometers around the specified location where the IP address is likely to be. - asn_country_iso_code: The ISO code of the country of the Autonomous System (AS) owner of the IP address. - city_geoname_code:: City geoname code. The geoname code by [GeoNames](https://en.wikipedia.org/wiki/GeoNames) is a unique identifier assigned to each geographical point on the globe. -cityname:: City name, in english. The developer can use the geoname code to localize the name of the city. - ``continentcode: The continent code. It can be any of the following: AF, AN, AS, EU, NA, OC, SA. -countryisocode: The country ISO 3166-1 alpha-2 code. -hostnames: The list of hostnames associated with the IP address obtained from the reverse DNS lookup. -latitude: The latitude of the geolocation. -longitude: The longitude of the geolocation. -postalcode:: The postal code of the city. - ``regiongeonamecode:: The geoname code of the region. - ``regionname:: The region name, in english. The developer can use the geoname code to localize the name of the region. - time_zone: The name of the time zone.

Errors

The endpoint will return the following errors: - a 400 Bad Request error if the IP address is not public. - a 422 Unprocessable Entity error if the IP address is malformed.

It will also return the API Global errors described in the API description.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"hostnames":["Excepteur dolore","incididunt Ut"],"latitude":-74317069.9622997,"longitude":-5764157.350812927,"time_zone":"elit reprehenderit nisi consequat","accuracy_radius":-69906741.4653793,"postal_code":"ullamco enim","city_name":"id sunt","city_geoname_code":-58980328,"region_name":"dolor dolor Ut","region_geoname_code":-34007142,"country_iso_code":"aliqua est do velit","asn_country_iso_code":"anim","continent_code":"est","self":"U"}