Timezone Lookup API

Send a coordinate and get the IANA timezone name, the current UTC offset, whether daylight saving is in effect, and the local time. Send a timestamp too and get the offset that applied, or will apply, at that moment, which is what you need for scheduling and for historical records.

GEThttps://api.mygeocode.com/v1/timezone?lat=...&lon=...

Try it in the demo Full reference

Example

Request

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/timezone?lat=35.6762&lon=139.6503"

# At a specific moment (Unix seconds)
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/timezone?lat=40.7128&lon=-74.0060&timestamp=1773817200"

Store the timezone name, not the offset. Offsets change twice a year in many places and occasionally for good when a government changes the rules. The IANA name stays valid, and the rules are updated here within a day of each IANA release.

Response

{
  "status": "ok",
  "lat": 35.6762,
  "lon": 139.6503,
  "timezone": "Asia/Tokyo",
  "name": "Japan Standard Time",
  "abbreviation": "JST",
  "utc_offset": "+09:00",
  "utc_offset_seconds": 32400,
  "raw_offset_seconds": 32400,
  "dst": false,
  "dst_offset_seconds": 0,
  "timestamp": 1791094436,
  "local_time": "2026-10-04T15:13:56+09:00",
  "country_code": "JP",
  "is_ocean": false,
  "windows_timezone": "Tokyo Standard Time",
  "next_transition": null
}

What you get back

Field	Meaning
`timezone`	IANA name such as `Europe/Berlin`. In international waters, a nautical zone such as `Etc/GMT-3`.
`name`	The long name in force at the timestamp, such as `Japan Standard Time`.
`abbreviation`	The abbreviation in force at the timestamp: `CET`, `CEST`, `JST`. Not unique worldwide; display only.
`utc_offset`, `utc_offset_seconds`	The offset at the timestamp, as text and as a number.
`raw_offset_seconds`, `dst_offset_seconds`	The standard offset, and what daylight saving time adds to it at the timestamp (0 when it is not in effect).
`dst`	Whether daylight saving time is in effect at the timestamp.
`timestamp`, `local_time`	The moment the answer describes, as Unix seconds and as an RFC 3339 string in local time.
`country_code`	The country the point is in, if any.
`is_ocean`, `windows_timezone`	Whether the zone is a nautical one at sea, and the matching Windows zone id where there is one.
`next_transition`	The next change of offset within two years: its timestamp, offset, DST flag and abbreviation. `null` where the offset does not change.

Where it is used

Scheduling across sites

Send a reminder at 9 am local time at each store. Look up the timezone once per store and convert with your language's tz library.

Fixing timestamps in logs

Devices that record local time without an offset can be corrected after the fact by looking up the offset at that timestamp and location.

Showing local time to users

Display "it is 8:34 am there" next to a location on a map or a contact card.

Price and limits

One call, one request. Every account has 2,500 free requests a day, shared by all of its keys; past that, €0.0001 each from prepaid credit, or nothing on an Unlimited key (€50 a month). Pricing. The Google Time Zone API and Bing Time Zone formats are available as drop-in hosts.