---
title: "Timezone"
method: GET
path: "/timezone"
tags: ["Timezone"]
---

# Timezone

`GET /timezone`

The Timezone API provides time offset data for locations on the surface of the earth.

## Query parameters

- `lat` number, float, required
- `lon` number, float, required
- `timestamp` number

## Response `200`

OK

- Timezone
  - `timezone` object — Timezone object found for the location.
    - `name` string — Timezone identifier, compatible with the IANA Tz Database. Typically in the format "Area/Location" (e.g., "America/New_York", "Europe/Paris"), but can also include ocean areas (e.g., "Atlantic/Azores") and special administrative zones (e.g., "Etc/UTC", "Etc/GMT-14"). We always return the most current identifier (e.g., "Asia/Kolkata", not "Asia/Calcutta"). Note that "Etc/GMT" zones use POSIX-style signs, opposite to ISO 8601 convention (e.g., "Etc/GMT-14" is 14 hours ahead of GMT).
    - `now_in_dst` integer — Represents whether the zone currently observing `DST` or not.
    - `offset_sec` integer — The offset from `UTC` (in seconds) for the given location. Considers `DST` savings.
    - `short_name` string — Time zone abbreviation, usually 3 or 4 letters (e.g., "EDT" for Eastern Daylight Time, "CEST" for Central European Summer Time). In some cases, especially for locations without standardized abbreviations, it may be a numeric UTC offset (e.g., "+03" or "+0330").
    - `full_name` string — Complete, descriptive name of the time zone, e.g. "Pacific Daylight Time" or "Central European Standard Time". For some locations (e.g., oceans) where such a name is unavailable, it is returned in the format of GMT±HH:MM (e.g., GMT+03:30).

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — The request has been made from an unauthorized domain.
- `404` — No location or places were found for the given input.
- `429` — Request exceeded the rate-limits set on your account.
- `500` — Internal Server Error

---

[API](https://skmtc.dev/locationiq/apis/locationiq-api-reference.md) · [All operations](https://skmtc.dev/locationiq/apis/locationiq-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/locationiq/locationiq-api-reference/revisions/62f2eab3d1ff/schema)
