# timezone.io

> Timezone information and conversion platform with a free REST API for IANA time zones — live UTC offsets, DST status, and upcoming transitions.

The timezone.io API returns JSON and requires a free personal access token from a verified account. The base URL is https://api.timezone.io/v1. The pages below link to plain-markdown versions of the documentation.

## Docs

- [Overview](https://www.timezone.io/docs/introduction.md): Introduction to the timezone.io API: base URL, response format, and conventions.
- [Quickstart](https://www.timezone.io/docs/quickstart.md): From zero to your first API response in two minutes — with curl, JavaScript, and Python examples.
- [Authentication](https://www.timezone.io/docs/authentication.md): Create an API token and authenticate your requests to the timezone.io API.
- [Rate limits](https://www.timezone.io/docs/rate-limits.md): Request limits, rate-limit headers, and handling 429 responses.
- [Timezones](https://www.timezone.io/docs/timezones.md): List and retrieve IANA time zones with live offsets, DST status, and transitions.
- [Abbreviations](https://www.timezone.io/docs/abbreviations.md): Browse the named time-zone layer (EST, CET, JST): defining offsets, DST counterparts, and member zones.
- [Countries](https://www.timezone.io/docs/countries.md): Browse countries and territories: ISO codes, default time zone, DST summary, counts, and dependencies.
- [Cities](https://www.timezone.io/docs/cities.md): Look up cities with their live local time and live sunrise, sunset, and daylight length.
- [Convert](https://www.timezone.io/docs/convert.md): Convert a moment between timezones with DST fold/gap disclosure and multi-target support.
- [Errors](https://www.timezone.io/docs/errors.md): Error status codes and the JSON response shapes returned by the API.