Timezone

GET/v0/timezone

Validates an IANA timezone identifier (e.g. Europe/Warsaw, America/New_York). Input is case-insensitive. When valid, the canonical timezone name is returned together with the current UTC offset, abbreviation, and whether Daylight Saving Time (DST) is currently in effect.

Try it

Query Parameters

Parameter	Type	Required	Description
value	string	Yes	IANA timezone identifier, case-insensitive (e.g. `Europe/Warsaw`, `US/Eastern`)

Example Requests

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/timezone?value=Europe/Warsaw"

Response Fields

Field	Type	Description
valid	boolean	Whether the value is a recognised IANA timezone
timezone	string	Canonical IANA timezone identifier
region	string \| null	Top-level region (e.g. `Europe`, `America`). `null` for timezones without a region prefix.
utcOffset	string	Current UTC offset (e.g. +01:00, -05:00)
abbreviation	string	Current timezone abbreviation (e.g. CET, EST)
isDST	boolean	Whether Daylight Saving Time is currently in effect

Example Response

{
  "valid": true,
  "timezone": "Europe/Warsaw",
  "region": "Europe",
  "utcOffset": "+01:00",
  "abbreviation": "CET",
  "isDST": false
}

Example Response — invalid

{
  "valid": false
}

GET/v0/timezone/list

Returns the complete list of all IANA timezones with their current UTC offset, abbreviation, and Daylight Saving Time (DST) status. Optionally filter by region.

Query Parameters

Parameter	Type	Required	Description
region	string	No	Filter by top-level region, case-insensitive (e.g. `Europe`, `America`, `Asia`)

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/timezone/list?region=Europe"

Object Fields

Field	Type	Description
timezone	string	IANA timezone identifier
region	string \| null	Top-level region
utcOffset	string	Current UTC offset
abbreviation	string	Current timezone abbreviation
isDST	boolean	Whether Daylight Saving Time is currently in effect

Example Response

[
  { "timezone": "Europe/Amsterdam", "region": "Europe", "utcOffset": "+01:00", "abbreviation": "CET", "isDST": false },
  { "timezone": "Europe/Berlin", "region": "Europe", "utcOffset": "+01:00", "abbreviation": "CET", "isDST": false },
  { "timezone": "Europe/Warsaw", "region": "Europe", "utcOffset": "+01:00", "abbreviation": "CET", "isDST": false },
  ...
]