apyhub
Back
▣ 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
https://api.eu.apyhub.com/apyhub/list-timezones

QUICKSTART

GUIDE

Quickstart

Fetch the list of timezones with a simple GET request.

curl -X GET "https://api.eu.apyhub.com/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
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.

ParameterTypeDescription
dataObject ArrayArray of timezone objects.
data[].keyStringISO 3166-1 alpha-2 country code.
data[].valueStringIANA timezone name.
data[].utc_timeStringCurrent UTC offset, computed live and reflecting DST.
data[].abbreviationString ArrayTimezone abbreviations.
▣ 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.

Similar APIs

Closest matches in the catalog based on this service.

CALLTimezones List APIDosvak LLCCALLConvert Timezone and Meeting Planner APInick creightonCALLConvert Timezone APIDosvak LLCCALLConvert Date & Time Formats APInick creighton

From the blog

Reads that touch this API.

Timezones Dictionary API: Global Timezone Data and Best Alternatives for 2026Jul 9, 2026Ultimate Guide to Country Codes: What They Are and How to Use ThemJul 9, 2026Two-Letter Abbreviations for Countries (ISO 3166-1 Alpha-2 Codes) ExplainedSep 10, 2026Getting Started with APIs: A Beginner’s Guide 2026Sep 17, 2026