---
title: "Get time zone information for any point on earth."
method: GET
path: "/tz/lookup/v2"
tags: ["Geospatial"]
---

# Get time zone information for any point on earth.

`GET /tz/lookup/v2`

Retrieve the time zone identifier, total UTC offset, whether DST is in effect, and the localized time in several common formats.

## Query parameters

- `lat` number, double, required
- `lng` number, double, required
- `timestamp` integer

## Response `200`

The time zone information and local time.

- TzResponseV2
  - `tz_id` string, required — The canonical time zone ID. In the event that multiple time zones could be returned, the first one from the Unicode CLDR timezone.xml is returned.
  - `utc_offset` integer, required — The total offset, in seconds, from UTC that is currently in effect for this time zone. This accounts for both the standard offset and any seasonal adjustments (e.g. DST).
  - `is_dst` boolean, required — Whether Daylight Saving Time (or a similar seasonal offset) is in effect at the queried timestamp.
  - `timestamp` integer, required — Integer non-leap seconds since January 1, 1970 (UNIX timestamp). If present, offsets will be calculated as of this time. Otherwise, offsets will be effective as of the time of the query.
  - `local_rfc_2822_timestamp` string, nullable — The local time expressed as an RFC 2822 timestamp (e.g. Tue, 1 Jun 2003 10:52:37 -0500). If a timestamp is included in the request, it will be localized here. Otherwise, this will reflect the time of the request. NOTE: RFC 2822 is more restrictive than other formats and cannot represent all dates.
  - `local_rfc_3339_timestamp` string, required — The local time expressed as an RFC 3339 (ISO 8601) timestamp (e.g. 2003-06-01T10:52:37+02:00). If a timestamp is included in the request, it will be localized here. Otherwise, this will reflect the time of the request.

## Other responses

- `400` — Bad request
- `404` — Time zone not found

---

[API](https://skmtc.net/stadiamaps/apis/stadia-maps-geospatial-apis.md) · [All operations](https://skmtc.net/stadiamaps/apis/stadia-maps-geospatial-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stadiamaps/stadia-maps-geospatial-apis/versions/99e0701a73aa/schema)