Get the time zone information and country information of the requesting IP. If there is no value in the ip field in Request Body, the time zone and the country information of the IP calling this API is returned.

  • Request URL
    Common URL
    Distributed Environment URL
    Sandbox URL
    HTTP Method POST
    Content-Type text/html
    Data Format JSON
  • Request Body
    Field Name Description Required
    ip If the requesting IP(IPv4 or IPv6) is null, it gets the time zone and the country data through the IP of API-implementing client. N
  • Response
    Field Name Description Required
    result_code Result code. 0=Success Integer
    result_msg Result message String
    timezone Object-type time zone
    Refer to the following Timezone object
    • true: the country code of the timezone used by ip != the country code based on ip‘s geolocation
    • false: the country code of the timezone used by ip == the country code based on ip‘s geolocation

    The northern part of Vietnam (VN) uses the Asia/Bangkok time zone, and the southern part uses the Asia/Ho_Chi_Minh time zone. By the way, the country code for the Asia/Bangkok time zone is Thailand (TH). The country code (VN) of northern Vietnam based on IP’s geolocation and the country code (TH) of the time zone used by northern Vietnam are different.

  • Timezone object
    Field Name Description Type
    zone_id Location identifiers provided by time zone database String
    country_code Country code based on the ISO 3166-1 alpha-2 String
    zone_name Local name String
    country_name Country name String
    abbreviation The abbreviation of standard time by country String
    gmt_offset Time difference (Unit: second) String
    dst The use of summer time String
  • Request Sample
  • Response Sample

When the time zone of requesting IP is not identified, success is returned as result value, and “UNKNOWN” is returned as country_code value.

  • Response Sample in case IP unable to identify the time zone