▣ GEOLOCATION · STANDARD DATA

Timezones Dictionary API

Hosted on ApyHub

What it does

Time Zone List returns a live list of time zones with their current UTC offsets. Each item includes a country code, an IANA time zone name, the current offset, and any matching abbreviations.

Use it when you need a reference dataset for scheduling, calendar logic, region-aware defaults, or UI pickers that map countries to time zones. The offset is computed live, so it reflects daylight saving time changes without you maintaining your own table.

The response is a single data array of objects. For each time zone entry, you get key for the ISO 3166-1 alpha-2 country code, value for the IANA timezone name, utc_time for the current UTC offset, and abbreviation for one or more common timezone abbreviations.

If you are building booking flows, attendance tools, delivery planning, or user profile settings, Time Zone List gives you a straightforward source of reference time zone data in a format that is easy to consume.

GET

List all timezones with current UTC offset

http://localhost:8080/apyhub/list-timezones

QUICKSTARTGUIDE

Quickstart

Fetch the list of timezones with a simple GET request.

curl -X GET "http://localhost:8080/apyhub/list-timezones" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a data array. Each item in the array is an object with key (ISO 3166-1 alpha-2 country code), value (IANA timezone name), utc_time (current UTC offset), and abbreviation (an array of timezone abbreviations).

{
  "data": [
    {
      "key": "US",
      "value": "America/New_York",
      "utc_time": "UTC -05:0",
      "abbreviation": ["EST", "EDT"]
    }
  ]
}

TRY ITLIVE · 5 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns a JSON object containing a data array of timezone records with each record’s country code, IANA timezone name, current UTC offset, and abbreviations.

Response

Returns a JSON object with a data array field. Each item in data is an object with key, value, utc_time, and abbreviation fields.

Parameter	Type	Mandatory	Description
data	Object Array	Yes	Array of timezone objects.
data[].key	String	Yes	ISO 3166-1 alpha-2 country code.
data[].value	String	Yes	IANA timezone name.
data[].utc_time	String	Yes	Current UTC offset, computed live and reflecting DST.
data[].abbreviation	String Array	Yes	Timezone abbreviations.

Parameters

No parameters.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.