---
title: "Timezone-at-coordinate endpoint (see module docs)."
method: GET
path: "/timezone"
tags: ["timezone"]
---

# Timezone-at-coordinate endpoint (see module docs).

`GET /timezone`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/timezone`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

## Query parameters

- `lat` number, double, required
- `lon` number, double, required
- `timestamp` string

## Response `200`

`{tzid, utc_offset_s, dst_offset_s, abbreviation, timestamp}`. `tzid` and every derived field are `null` together when no loaded zone covers the point: an honest "no data", never a guess

- object

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `429`: Quota or rate limit exceeded
- `501`: Timezone lookup not enabled (SN_TIMEZONE_SQLITE unset or failed to load)

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)