IPGeolocation.io · Schema

Location

Geolocation information associated with the requested IP address or location query. This object appears when the timezone lookup is performed using the `ip` or `location` parameters. It provides geographic details such as continent, country, administrative regions, and coordinates used to determine the corresponding timezone.

GeocodingIP GeolocationIP IntelligenceIP SecurityASN LookupAbuse ContactTimezoneAstronomyUser AgentThreat IntelligencePublic APIs

Properties

Name	Type	Description
location_string	string	Original location string provided in the request.
continent_code	string	Two-letter continent code.
continent_name	string	Full name of the continent.
country_code2	string	ISO 3166-1 alpha-2 country code.
country_code3	string	ISO 3166-1 alpha-3 country code.
country_name	string	Common name of the country.
country_name_official	string	Official name of the country.
is_eu	boolean	Indicates whether the country is a member of the European Union.
state_prov	string	State, province, or region name.
state_code	string	Standardized state or region code.
district	string	District or administrative subdivision.
city	string	City name of the location.
locality	string	Smaller locality or neighborhood within the city.
zipcode	string	ZIP or postal code of the location.
latitude	string	Latitude coordinate of the location.
longitude	string	Longitude coordinate of the location.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ipgeolocation/refs/heads/main/json-schema/timezone-location-schema.json",
  "title": "Location",
  "description": "Geolocation information associated with the requested IP address\nor location query.\n\nThis object appears when the timezone lookup is performed using\nthe `ip` or `location` parameters.\n\nIt provides geographic details such as continent, country,\nadministrative regions, and coordinates used to determine the\ncorresponding timezone.\n",
  "type": "object",
  "properties": {
    "location_string": {
      "type": "string",
      "description": "Original location string provided in the request.",
      "example": "London, UK"
    },
    "continent_code": {
      "type": "string",
      "description": "Two-letter continent code.",
      "example": "EU"
    },
    "continent_name": {
      "type": "string",
      "description": "Full name of the continent.",
      "example": "Europe"
    },
    "country_code2": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code.",
      "example": "GB"
    },
    "country_code3": {
      "type": "string",
      "description": "ISO 3166-1 alpha-3 country code.",
      "example": "GBR"
    },
    "country_name": {
      "type": "string",
      "description": "Common name of the country.",
      "example": "United Kingdom"
    },
    "country_name_official": {
      "type": "string",
      "description": "Official name of the country.",
      "example": "United Kingdom of Great Britain and Northern Ireland"
    },
    "is_eu": {
      "type": "boolean",
      "description": "Indicates whether the country is a member of the European Union."
    },
    "state_prov": {
      "type": "string",
      "description": "State, province, or region name.",
      "example": "England"
    },
    "state_code": {
      "type": "string",
      "description": "Standardized state or region code.",
      "example": "GB-ENG"
    },
    "district": {
      "type": "string",
      "description": "District or administrative subdivision.",
      "example": "Greater London"
    },
    "city": {
      "type": "string",
      "description": "City name of the location.",
      "example": "London"
    },
    "locality": {
      "type": "string",
      "description": "Smaller locality or neighborhood within the city.",
      "example": "Westminster"
    },
    "zipcode": {
      "type": "string",
      "description": "ZIP or postal code of the location.",
      "example": "SW1A"
    },
    "latitude": {
      "type": "string",
      "description": "Latitude coordinate of the location.",
      "example": "51.50002"
    },
    "longitude": {
      "type": "string",
      "description": "Longitude coordinate of the location.",
      "example": "-0.19244"
    }
  }
}