{"openapi":"3.1.0","info":{"title":"Time Zones API","version":"1.0.0","description":"Every IANA time zone with its coordinates and country, enriched in real time with the current UTC offset, abbreviation, DST status and local time (computed from the system ICU time-zone database — always up to date, no key). Look up a zone by name, list all zones for a country, search zones by name, or find the nearest IANA zones to any latitude/longitude. 418 zones across 247 countries/territories. Ideal for scheduling, calendars, logistics, geo apps and any feature that needs to map a place or coordinate to the right time zone and current local time.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/timezones-api","description":"oanor gateway"}],"tags":[{"name":"Zones"},{"name":"Geo"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/country":{"get":{"operationId":"get_v1_country","tags":["Zones"],"summary":"All zones for a country","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"2-letter ISO country code","schema":{"type":"string"},"example":"US"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":29,"zones":[{"lat":40.7142,"long":-73.9936,"name":"America/New_York","is_dst":true,"comments":"Eastern (most areas)","countries":["US"],"local_time":"2026-06-08T14:25:13","utc_offset":"-04:00","abbreviation":"EDT","observes_dst":true,"offset_minutes":-240},{"lat":42.3314,"long":-82.9542,"name":"America/Detroit","is_dst":true,"comments":"Eastern - MI (most areas)","countries":["US"],"local_time":"2026-06-08T14:25:13","utc_offset":"-04:00","abbreviation":"EDT","observes_dst":true,"offset_minutes":-240},{"lat":38.2542,"long":-84.2406,"name":"America/Kentucky/Louisville","is_dst":true,"comments":"Eastern - KY (Louisville area)","countries":["US"],"local_time":"2026-06-08T14:25:13","utc_offset":"-04:00","abbreviation":"EDT","observes_dst":true,"offset_minutes":-240},{"lat":36.8297,"long":-83.1508,"name":"America/Kentucky/Monticello","is_dst":true,"comments":"Eastern - KY (Wayne)","countries":["US"],"local_time":"2026-06-08T14:25:13","utc_offset":"-04:00","abbreviation":"EDT","observes_dst":true,"offset_minutes":-240},{"lat":39.7683,"long":-85.8419,"name":"America/Indiana/Indianapolis","is_dst":true,"comments":"Eastern - IN (most areas)","countries":["US"],"local_time":"2026-06-08T14:25:13","utc_offset":"-04:00","abbreviation":"EDT","observes_dst":true,"offset_minutes":-240},{"lat":38.6772,"long":-86.4714,"name":"America/Indiana/Vincennes","is_dst":true,"comments":"Eastern - IN (Da, Du, K, Mn)","countries":["US"],"local_time":"2026-06-08T14:25:13","utc_offset":"-04:00","abbreviation":"EDT","observes_dst":true,"offset_minutes":-240},{"lat":41.0514,"long":-85.3969,"name":"America/Indiana/Winamac","is_dst":true,"comments":"Eastern - IN (Pulaski)","countries":["US"],"local_time":"2026-06-08T14:25:13","utc_offset":"-04:00","abbreviation":"EDT","observes_dst":true,"offset_minutes":-240},{"lat":38.3756,"long":-85.6553,"name":"America/Indiana/Marengo","is_dst":true,"comments":"Eastern - IN (Crawford)","countries":["US"],"local_time":"2026-06-08T14:25:13","utc_offset":"-04:00","abbreviation":"EDT","observes_dst":true,"offset_minutes":-240},{"lat":38.4919,"long":-86.7214,"name":"America/Indiana/Petersburg","is_dst":true,"comments":"Eastern - IN (Pike)","countries":["US"],"local_time":"2026-06-08T14:25:13","utc_offset":"-04:00","abbreviation":"EDT","observes_dst":true,"offset_minutes":-240},{"lat":38.7478,"long":-84.9328,"name":"America/Indiana/Vevay","is_dst":true,"comments":"Eastern - IN (Switzerland)","countries":["US"],"local_time":"2026-06-08T14:25:13","utc_offset":"-04:00","abbreviation":"EDT","observes_dst":true,"offset_minutes":-240},{"lat":41.85,"long":-86.35,"name":"America/Chicago","is_dst":true,"comments":"Central (most areas)","countries":["US"],"local_time":"2026-06-08T13:25:13","utc_offset":"-05:00","abbreviation":"CDT","observes_dst":true,"offset_minutes":-300},{"lat":37.9531,"long":-85.2386,"name":"America/Indiana/Tell_City","is_dst":true,"comments":"Central - IN (Perry)","countries":["US"],"local_time":"2026-06-08T13:25:13","utc_offset":"-05:00","abbreviation":"CDT","observes_dst":true,"offset_minutes":-300},{"lat":41.2958,"long":-85.375,"name":"America/Indiana/Knox","is_dst":true,"comments":"Central - IN (Starke)","countries":["US"],"local_time":"2026-06-08T13:25:13","utc_offset":"-05:00","abbreviation":"CDT","observes_dst":true,"offset_minutes":-300},{"lat":45.1078,"long":-86.3858,"name":"America/Menominee","is_dst":true,"comments":"Central - MI (Wisconsin border)","countries":["US"],"local_time":"2026-06-08T13:25:13","utc_offset":"-05:00","abbreviation":"CDT","observes_dst":true,"offset_minutes":-300},{"lat":47.1164,"long":-100.7008,"name":"America/North_Dakota/Center","is_dst":true,"comments":"Central - ND (Oliver)","countries":["US"],"local_time":"2026-06-08T13:25:13","utc_offset":"-05:00","abbreviation":"CDT","observes_dst":true,"offset_minutes":-300},{"lat":46.845,"long":-100.5892,"name":"America/North_Dakota/New_Salem","is_dst":true,"comments":"Central - ND (Morton rural)","countries":["US"],"local_time":"2026-06-08T13:25:13","utc_offset":"-05:00","abbreviation":"CDT","observes_dst":true,"offset_minutes":-300},{"lat":47.2642,"long":-100.2222,"name":"America/North_Dakota/Beulah","is_dst":true,"comments":"Central - ND (Mercer)","countries":["US"],"local_time":"2026-06-08T13:25:13","utc_offset":"-05:00","abbreviation":"CDT","observes_dst":true,"offset_minutes":-300},{"lat":39.7392,"long":-103.0158,"name":"America/Denver","is_dst":true,"comments":"Mountain (most areas)","countries":["US"],"local_time":"2026-06-08T12:25:13","utc_offset":"-06:00","abbreviation":"MDT","observes_dst":true,"offset_minutes":-360},{"lat":43.6136,"long":-115.7975,"name":"America/Boise","is_dst":true,"comments":"Mountain - ID (south), OR (east)","countries":["US"],"local_time":"2026-06-08T12:25:13","utc_offset":"-06:00","abbreviation":"MDT","observes_dst":true,"offset_minutes":-360},{"lat":33.4483,"long":-111.9267,"name":"America/Phoenix","is_dst":false,"comments":"MST - AZ (most areas), Creston BC","countries":["US","CA"],"local_time":"2026-06-08T11:25:13","utc_offset":"-07:00","abbreviation":"MST","observes_dst":false,"offset_minutes":-420},{"lat":34.0522,"long":-117.7572,"name":"America/Los_Angeles","is_dst":true,"comments":"Pacific","countries":["US"],"local_time":"2026-06-08T11:25:13","utc_offset":"-07:00","abbreviation":"PDT","observes_dst":true,"offset_minutes":-420},{"lat":61.2181,"long":-148.0997,"name":"America/Anchorage","is_dst":true,"comments":"Alaska (most areas)","countries":["US"],"local_time":"2026-06-08T10:25:13","utc_offset":"-08:00","abbreviation":"AKDT","observes_dst":true,"offset_minutes":-480},{"lat":58.3019,"long":-133.5803,"name":"America/Juneau","is_dst":true,"comments":"Alaska - Juneau area","countries":["US"],"local_time":"2026-06-08T10:25:13","utc_offset":"-08:00","abbreviation":"AKDT","observes_dst":true,"offset_minutes":-480},{"lat":57.1764,"long":-134.6981,"name":"America/Sitka","is_dst":true,"comments":"Alaska - Sitka area","countries":["US"],"local_time":"2026-06-08T10:25:13","utc_offset":"-08:00","abbreviation":"AKDT","observes_dst":true,"offset_minutes":-480},{"lat":55.1269,"long":-130.4236,"name":"America/Metlakatla","is_dst":true,"comments":"Alaska - Annette Island","countries":["US"],"local_time":"2026-06-08T10:25:13","utc_offset":"-08:00","abbreviation":"AKDT","observes_dst":true,"offset_minutes":-480},{"lat":59.5469,"long":-138.2728,"name":"America/Yakutat","is_dst":true,"comments":"Alaska - Yakutat","countries":["US"],"local_time":"2026-06-08T10:25:13","utc_offset":"-08:00","abbreviation":"AKDT","observes_dst":true,"offset_minutes":-480},{"lat":64.5011,"long":-164.5936,"name":"America/Nome","is_dst":true,"comments":"Alaska (west)","countries":["US"],"local_time":"2026-06-08T10:25:13","utc_offset":"-08:00","abbreviation":"AKDT","observes_dst":true,"offset_minutes":-480},{"lat":51.88,"long":-175.3419,"name":"America/Adak","is_dst":true,"comments":"Alaska - western Aleutians","countries":["US"],"local_time":"2026-06-08T09:25:13","utc_offset":"-09:00","abbreviation":"HADT","observes_dst":true,"offset_minutes":-540},{"lat":21.3069,"long":-156.1417,"name":"Pacific/Honolulu","is_dst":false,"comments":"Hawaii","countries":["US"],"local_time":"2026-06-08T08:25:13","utc_offset":"-10:00","abbreviation":"HST","observes_dst":false,"offset_minutes":-600}],"country":{"code":"US","name":"United States"}},"meta":{"timestamp":"2026-06-08T18:25:13.790Z","request_id":"38783c75-c535-4afe-ae12-912701ddd4c1"},"status":"ok","message":"Country zones retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Zones"],"summary":"Search zones by name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Substring (min 2 chars)","schema":{"type":"string"},"example":"berlin"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 25)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"query":"berlin","total":1,"zones":[{"lat":52.5,"long":13.3667,"name":"Europe/Berlin","is_dst":true,"comments":"most of Germany","countries":["DE","DK","NO","SE","SJ"],"local_time":"2026-06-08T20:25:13","utc_offset":"+02:00","abbreviation":"GMT+2","observes_dst":true,"offset_minutes":120}]},"meta":{"timestamp":"2026-06-08T18:25:13.905Z","request_id":"64fb71af-04ac-4255-8855-47890da1c731"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/zone":{"get":{"operationId":"get_v1_zone","tags":["Zones"],"summary":"Zone detail with current offset/DST/local time","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"IANA time-zone name","schema":{"type":"string"},"example":"Asia/Tokyo"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"zone":{"lat":35.6544,"long":139.7447,"name":"Asia/Tokyo","is_dst":false,"comments":"Eyre Bird Observatory","countries":["JP","AU"],"local_time":"2026-06-09T03:25:14","utc_offset":"+09:00","abbreviation":"GMT+9","observes_dst":false,"offset_minutes":540}},"meta":{"timestamp":"2026-06-08T18:25:14.024Z","request_id":"56aac631-1d40-439a-87f9-59997eba2add"},"status":"ok","message":"Zone retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/nearby":{"get":{"operationId":"get_v1_nearby","tags":["Geo"],"summary":"Nearest IANA zones to a coordinate","description":"","parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude (-90..90)","schema":{"type":"string"},"example":"48.85"},{"name":"lon","in":"query","required":true,"description":"Longitude (-180..180)","schema":{"type":"string"},"example":"2.35"},{"name":"limit","in":"query","required":false,"description":"Max results (1-25, default 5)","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":5,"query":{"lat":48.85,"lon":2.35},"zones":[{"lat":48.8667,"long":2.3333,"name":"Europe/Paris","is_dst":true,"countries":["FR","MC"],"local_time":"2026-06-08T20:25:14","utc_offset":"+02:00","distance_km":2.2,"abbreviation":"GMT+2","observes_dst":true,"offset_minutes":120},{"lat":50.8333,"long":4.3333,"name":"Europe/Brussels","is_dst":true,"countries":["BE","LU","NL"],"local_time":"2026-06-08T20:25:14","utc_offset":"+02:00","distance_km":262.4,"abbreviation":"GMT+2","observes_dst":true,"offset_minutes":120},{"lat":49.4547,"long":-1.4639,"name":"Europe/Guernsey","is_dst":true,"countries":["GG"],"local_time":"2026-06-08T19:25:14","utc_offset":"+01:00","distance_km":285.4,"abbreviation":"GMT+1","observes_dst":true,"offset_minutes":60},{"lat":49.6,"long":6.15,"name":"Europe/Luxembourg","is_dst":true,"countries":["LU"],"local_time":"2026-06-08T20:25:14","utc_offset":"+02:00","distance_km":288.2,"abbreviation":"GMT+2","observes_dst":true,"offset_minutes":120},{"lat":49.1836,"long":-1.8933,"name":"Europe/Jersey","is_dst":true,"countries":["JE"],"local_time":"2026-06-08T19:25:14","utc_offset":"+01:00","distance_km":311.6,"abbreviation":"GMT+1","observes_dst":true,"offset_minutes":60}]},"meta":{"timestamp":"2026-06-08T18:25:14.133Z","request_id":"d630e196-4924-4e26-b089-a2de4e64f1d9"},"status":"ok","message":"Nearest zones retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec & dataset stats","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"timezones-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/zone":"Zone detail incl. current offset/DST/local time (name=, e.g. Asia/Tokyo).","GET /v1/nearby":"Nearest IANA zones to a coordinate (lat=, lon=, limit=).","GET /v1/search":"Search zones by name (q=, min 2 chars).","GET /v1/country":"All zones for an ISO country code (code=, e.g. US)."},"description":"Every IANA time zone with coordinates, country, and the LIVE UTC offset, abbreviation, DST status and local time (computed from the system ICU tz database). Look up a zone, list a country's zones, search by name, or find the nearest zones to a coordinate. No key.","total_zones":418,"total_countries":247},"meta":{"timestamp":"2026-06-08T18:25:14.235Z","request_id":"799e82ea-17fd-4a7b-a9a9-de3af613554b"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":8000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":600,"monthly_call_quota":80000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1900,"monthly_call_quota":450000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4700,"monthly_call_quota":2000000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/timezones-api"}