apyhub
GEOLOCATION · STANDARD DATA

Timezones List API

What it does

Time Zone List returns the full set of IANA timezone names, with an optional keyword filter for narrowing the results. Send a search query string and get back a timezones array of matching timezone identifiers.

Use it when you need a dependable source of timezone names for scheduling, user profile settings, region pickers, or validation in forms and admin tools. Because the response is just the timezone list, it fits cleanly into lookup flows where you already know how to present or cache reference data.

Time Zone List is useful anywhere you need to avoid hardcoding timezone values or keeping a local copy of the IANA set up to date. Filter by keyword to find the subset you need, or request the full list when populating dropdowns and syncing reference tables.

GET
List all IANA timezone names with optional keyword filter
http://localhost:8080/dosvak/timezone-list
QUICKSTARTGUIDE

Quickstart

Search for time zones by name or list all time zones if you omit the optional query.

curl -X GET "http://localhost:8080/dosvak/timezone-list?search=London" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a timezones array of strings — each string is a matching time zone name.

{
  "timezones": ["Europe/London", "Atlantic/Canary"]
}
TRY ITLIVE · 10 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 timezones string array of IANA timezone names. You can optionally filter the list by providing a search query string.

Query Parameter(s)

AttributeTypeMandatoryDescription
searchStringNoOptional keyword filter applied to the timezone list.

Response

Returns a JSON object with a timezones string array field containing IANA timezone names.

AttributeTypeMandatoryDescription
timezonesString ArrayYesThe list of IANA timezone names returned by the endpoint.

Query parameters

Name
Type
Description
searchOPTIONAL
string
▣ 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.