---
title: "List Global Time Zones records"
method: GET
path: "/v1/data/global-time-zones"
tags: ["Reference"]
---

# List Global Time Zones records

`GET /v1/data/global-time-zones`

## Request

- Base URL: `https://api.aristocles.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aristocles.com.au/v1/data/global-time-zones`
- Auth: none declared. Required headers: `X-API-Key`

List Global Time Zones records with optional filters and pagination.

**Source:** Denis Filipenko (https://github.com/dmfilipenko/timezones.json) (MIT).

**Fields returned:**
- `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.

**Example:** `GET /v1/data/global-time-zones?limit=10&utc_offset=4.2`

## Query parameters

- `limit` integer: Max records to return (1-100).
- `offset` integer: Records to skip, for pagination.
- `utc_offset` string, nullable: The time offset from Coordinated Universal Time (UTC) in hours.
- `is_dst` string, nullable: Indicates if the time zone is currently in Daylight Saving Time.

## Headers

- `X-API-Key` string, required

## Response `200`

A page of Global Time Zones records with pagination metadata.

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aristocles/apis/aristocles-data-api.md) · [All operations](https://skmtc.dev/aristocles/apis/aristocles-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aristocles/apis/aristocles-data-api/revisions/4ca3fbb73c59?raw)