Reference · Data API

Global Time Zones

A simple, clean, and accurate list of all IANA time zones worldwide.

Provides a developer-friendly list of global time zones, including abbreviation, UTC offset, and Daylight Saving Time (DST) status. This is a fundamental reference dataset for any application that needs to handle users in multiple geographic locations.

Get API key View docs

Source: Timezones.json by dmfilipenko · MIT · Denis Filipenko (https://github.com/dmfilipenko/timezones.json)

Endpoints

Every request is authenticated with your X-API-Key and counted against your plan.

GET /v1/data/global-time-zones
GET /v1/data/global-time-zones/search?q=...
GET /v1/data/global-time-zones/{key}

Base path /v1/data/global-time-zones · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.

Fields

Field	Type	Description
iana_name	str	The canonical IANA time zone name (e.g., 'Australia/Sydney').
abbreviation	str	The common abbreviation for the time zone (e.g., 'AEST').
utc_offset	float	The time offset from Coordinated Universal Time (UTC) in hours.
is_dst	bool	Indicates if the time zone is currently in Daylight Saving Time.
display_text	str	A human-readable string representing the time zone.

What you get

Based on the canonical IANA time zone database.

Simple and clean data structure.

Includes UTC offset and current DST status.

Easy to integrate into any application.

Maintained and updated by the open-source community.

FAQ

How often is this data updated?: The underlying IANA database is updated periodically as countries change their DST rules. The open-source project reflects these changes.
Does this handle historical time zone changes?: No, this dataset provides the current state of each time zone, not its entire history.

Pricing

Simple, transparent pricing

Start free, upgrade when you need more. All plans include full API access.

Free

$0forever

Get started and explore the API

100 requests/day

100 API requests per day
All endpoints included
Community support

Get Started

Pro

$9/month

For production apps and AI agents

10,000 requests/day

10,000 API requests per day
All endpoints included
Priority support
Usage dashboard

Upgrade to Pro

Enterprise

$49/month

Unlimited access for high-volume use

Unlimited requests

Unlimited API requests
All endpoints included
Priority support
Usage dashboard
Dedicated support channel

Go Enterprise

Getting Started

Start building in minutes

Register

Create an account to get your API key. It's free — no credit card required.

curl -X POST https://api.aristocles.com.au/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'

Make a request

Use your API key in the X-API-Key header to authenticate requests.

curl https://api.aristocles.com.au/v1/data/asx \
  -H "X-API-Key: your_api_key_here"

Upgrade

Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.

curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
  -H "X-API-Key: your_api_key_here"

Check usage

Monitor your daily request count and remaining quota at any time.

curl https://api.aristocles.com.au/v1/usage \
  -H "X-API-Key: your_api_key_here"