geo

Get geolocation information for an IP address

Changed on
get/geo/{ip}

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/geo/{ip}
  • Auth: HTTP bearer

Path parameters

ipstring required

IP address to geolocate (IPv4 or IPv6)

Response

Geolocation information retrieved

citystring nullable

City name

countrystring nullable

Country name

country_codestring nullable

ISO country code (2 letters)

ipstring required

IP address that was geolocated

is_euboolean required

Whether the IP is in the European Union

latitudenumber double nullable

Latitude coordinate

longitudenumber double nullable

Longitude coordinate

regionstring nullable

Region/state name

timezonestring nullable

Timezone identifier

Example response

{
  "city": "Mountain View",
  "country": "United States",
  "country_code": "US",
  "ip": "8.8.8.8",
  "latitude": 37.386,
  "longitude": -122.0838,
  "region": "California",
  "timezone": "America/Los_Angeles"
}

Changes

  • 4b228ebed583Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 1dc3e6788214Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status