▣ GEOLOCATION

Timezones Dictionary API

What it does

Time Zone List gives you a live list of time zones with their current UTC offsets. Send a request with no inputs and get back a data array of timezone records you can use for location lookup, scheduling, or timezone pickers.

Each item includes the ISO 3166-1 alpha-2 country key, the IANA timezone value, the current utc_time offset, and an abbreviation array. The offset is computed live, so it reflects daylight saving changes when they apply. That makes this endpoint useful when you need reference data that stays aligned with the current clock, not just a static timezone table.

Use Time Zone List when building signup forms, calendar apps, meeting schedulers, or admin tools that need to map countries to time zones. It is also useful for populating dropdowns, validating timezone choices, or matching user location data to an IANA timezone name without maintaining your own reference list.

The response is simple and structured, so you can filter, search, or group the returned records in your application without extra parsing.

GET

List all timezones with current UTC offset

https://api.eu.apyverse.com/apyhub/list-timezones

QUICKSTART

GUIDE

Quickstart

Fetch the list of timezones with a simple GET request.

curl -X GET "https://api.eu.apyverse.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 fields like key (ISO 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:00",
      "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 list of timezones with their current UTC offset information. The response is a JSON object containing a data array of timezone records.

Response

Returns a JSON object with a data array field. Each item in the array is an object containing the timezone record fields defined in the schema. Success status code is not declared in the schema.

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	Array of 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.