Timezone API: timezone and local time by coordinates
Send a latitude and longitude, and Geo API returns the point's IANA timezone (for example Europe/Istanbul), its current UTC offset, whether daylight saving time is in effect and its local time. For scheduling meetings, working out delivery hours and showing users their own local time.
How it works
/v1/timezone?lat=&lon= finds the point within the timezone boundaries. utc_offset and utc_offset_seconds give the current offset, dst whether daylight saving time is in effect, abbreviation the short name (such as EST) and local_time the local time at the moment of the request.
Offsets and daylight saving come from the rules of the IANA timezone database, so your application does not need to keep a timezone table.
Border areas and the open sea
Where two timezones overlap, the reply has ambiguous: true and the candidates field lists every zone with its own offset, daylight saving flag and local time; none is silently picked. A point on the open sea returns match: "none" instead of a guess.
What it is used for
Showing the local time of a store or a user's location, proposing meeting times for teams in different countries, and keeping notifications out of the recipient's night. With the same coordinate you can also find the country, state and district.
Example request and response
A point in New York, queried in winter. utc_offset, dst and abbreviation follow the moment queried: New York returns EST and -05:00 in winter, EDT, -04:00 and dst: true in summer. local_time also shows the moment of the request. This endpoint needs an API key.
Request
curl -H "Authorization: Bearer $GEO_API_KEY" "https://api.forlab.io/geo/v1/timezone?lat=40.7128&lon=-74.0060"Response excerpt
{
"data": {
"match": "found",
"timezone": "America/New_York",
"utc_offset": "-05:00",
"utc_offset_seconds": -18000,
"dst": false,
"abbreviation": "EST",
"local_time": "2026-11-21T14:09:31-05:00",
"ambiguous": false
},
"meta": { … }
}The same job with the Apify Actor
Without a key, or for a batch, give the Geo Reference Actor a list: each item becomes one result row that keeps the value you sent. Example input:
{"operation": "timezone", "items": [{"lat": 40.7128, "lon": -74.006}]}What it costs
- Apify Actor (timezone operation): $0.30 per 1,000 coordinate lookups.
- This endpoint has no free keyless use; for a key, email api@forlab.io.
- The live map on the Geo API page also shows the timezone of the point you click.
On Apify you pay as you go: only answered lookups are charged, items that cannot become a request are free, and each run adds a $0.001 start fee. The Apify free plan's $5 monthly credit covers about 16,000 coordinate lookups. For a direct API key, email api@forlab.io.
Frequently asked questions
Does it account for daylight saving time?
Yes. utc_offset is the offset right now and dst says whether daylight saving time is in effect. A zone with one offset all year, such as Turkey's, never returns dst: true.
Can I get all timezones of a country?
Yes. /v1/countries/{cc} lists the country's timezones; for Turkey that is only Europe/Istanbul.
Can I ask for a past or future date?
No. The reply gives the offset and local time at the moment of the request. For another date, use the returned IANA name with your own date library.
What happens for a point at sea?
The reply is match: "none" with timezone: null; the timezone of the nearest coast is not guessed.