Skip to content

50,000 free calls a month, card-free. Get an API key →

Documentation menu
docs / api / get-timezone
timezone

GET/timezone

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

Call it

bash
curl -fsS -X GET "https://api.mapmap.ai/timezone?lat=…&lon=…" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Parameters

NameInRequiredDescription
latqueryyesLatitude in decimal degrees
lonqueryyesLongitude in decimal degrees
timestampquerynoRFC 3339 or Unix seconds; defaults to now

Responses

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
400Invalid request
401Missing or invalid API key
429Quota or rate limit exceeded
501Timezone lookup not enabled (SN_TIMEZONE_SQLITE unset or failed to load)

Error bodies follow the shared problem model documented on API conventions.

Generated from https://api.mapmap.ai/openapi.json on 2026-09-17 · operationId get_timezone