timezone.io API
Every request needs a free personal access token from a verified timezone.io account, sent as a bearer token. The Free plan allows 100,000 requests a month at…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Every request needs a free personal access token from a verified timezone.io account, sent as a bearer token. The Free plan allows 100,000 requests a month at 5 a second; paid plans raise both (https://www.timezone.io/docs/rate-limits). Guides and worked examples: https://www.timezone.io/docs.
GET /lookup answers from time zone boundary data. Contains information from timezone-boundary-builder (https://github.com/evansiroky/timezone-boundary-builder), made available under the Open Database License (ODbL) 1.0 (https://opendatacommons.org/licenses/odbl/1-0/). Boundary data © OpenStreetMap contributors (https://www.openstreetmap.org/copyright).
Endpoints 10
Timezones
- GETList time zones
/timezonesA paginated, filterable list of IANA time zones. Rows are concise unless detail=full. - GETRetrieve a time zone
/timezones/:ianaOne IANA zone in full detail: live time, standard offset and the next DST transition. The slash in the identifier is part of the path; encode + as %2B.
Abbreviations
- GETList abbreviations
/abbreviationsA paginated list of named time standards (EST, CET, JST). Rows are concise unless detail=full. - GETRetrieve an abbreviation
/abbreviations/:abbreviationOne named time standard, by slug (always unique) or code. A code shared by several standards (AST, CST) returns 300 with candidates; narrow it with offset or…
Countries
- GETList countries
/countriesA paginated list of countries and territories. Rows are concise unless detail=full. - GETRetrieve a country
/countries/:countryOne country by slug (australia) or ISO 3166-1 alpha-2 code (AU).
Cities
- GETList cities
/citiesA paginated list of cities with their live UTC offset. Rows are concise unless detail=full. - GETRetrieve a city
/cities/:slugOne city with its live local time and live sunrise, sunset and daylight length. Cities that share a name are addressed as <slug>-<iso2> (barcelona-ve).
Convert
- GETConvert a moment between time zones
/convert?from=America/New_York&to=Europe/London,Asia/TokyoConvert one moment from a source to up to ten targets. Every datetime carries its UTC offset and is pinned to the single utc instant; daylight-saving folds…
Lookup
- GETFind the time zone at a point
/lookup?lat=48.8566The time zone at a latitude and longitude, on land or at sea, with the same timezone block as /timezones/{iana}, computed at at. Where two zones' boundaries…
API details
- Base URL
https://api.timezone.io/v1- Authentication
- A bearer token in the Authorization header
- Operations
- 10 operations on 10 pathsGET 10
- Main resources
- Abbreviations 2Cities 2Countries 2Timezones 2Convert 1Lookup 1
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
1.0.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
- Listed from
- Timezone's published OpenAPI description
How to test the timezone.io API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the timezone.io API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “List time zones” (GET /timezones), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the timezone.io API?
Every request needs a free personal access token from a verified timezone.io account, sent as a bearer token. The Free plan allows 100,000 requests a month at… It is listed under Developer tools and has 10 endpoints.
Who publishes the timezone.io API?
It is listed from timezone.io's public API description (an OpenAPI document), not published by timezone.io on Swastik Codes. Anyone who controls timezone.io can claim the profile by adding a DNS TXT record.
What is the base URL of the timezone.io API?
Requests go to https://api.timezone.io/v1. Endpoint paths are added to this base URL.
How do I authenticate with the timezone.io API?
With A bearer token in the Authorization header.
How many endpoints does the timezone.io API have?
10 operations on 10 paths (10 GET). The largest groups are Abbreviations, Cities, Countries, Timezones.
Is forking the timezone.io API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.