Time zones

Name: Time zones
Creator: IANA Time Zone Database
License: https://data.iana.org/time-zones/tz-link.html

IANA time zone identifiers from tzdata 2026d, grouped by area and searchable by city, country or tz id. Published by the IANA Time Zone Database.

Provenance

Source: IANA Time Zone Database
Effective version: 2026d
Retrieved: 2026-09-23
Refresh cadence: Several releases a year
Licence: Public domain. The tz database LICENSE states all data files are in the public domain. Read the licence
Attribution: IANA Time Zone Database 2026d

Field schema

430 items, across 2 hierarchy levels: area, zone.

area: 11
zone: 419

Every field this dataset’s items carry
Field	Type	Meaning
value	string	The canonical, unique value — what a query resolves to.
displayValue	string	The locale-resolved label a suggestion renders.
description	string, optional	Free-text detail shown beside the item. NAICS uses it for the ancestor breadcrumb; not every dataset sets it.
parentSourceId	string, optional	The parent item in the source’s own key space, for a hierarchical dataset.
hierarchyLevel	string, optional	Which level of the hierarchy this item sits at.
displayOrder	integer	Curated display order, distinct from relevance rank (`DEC-LIST-004`).
aliases	string[]	Alternate spellings that resolve to this item at no extra runtime KV read (`DEC-ALIAS-001`).
metadata	object	Dataset-specific fields — e.g. NAICS’s `code`/`level`/`trilateral`, or a country’s `alpha2`/`alpha3`/`numeric`.

A worked item

{
  "value": "Africa/Abidjan",
  "displayValue": "Abidjan",
  "description": "Africa › Côte d’Ivoire",
  "aliases": [
    "Africa/Abidjan",
    "Abidjan",
    "Côte d’Ivoire"
  ],
  "metadata": {
    "tzId": "Africa/Abidjan",
    "countryCodes": [
      "CI"
    ],
    "coordinates": "+0519-00402"
  },
  "ancestors": [
    {
      "value": "Africa",
      "displayValue": "Africa"
    }
  ]
}

Query it

/v1/query?key=YOUR_PUBLISHABLE_KEY&q=abidjan

The publishable key above is a public, browser-safe identifier — never a secret.

Download

The licence above permits redistributing the compiled list as a file. Download Time zones as JSON.

API reference: query