Skip to main content
GET
/
v1
/
api
/
timezone_options
/
curl -X GET "https://api.hookpulse.io/v1/api/timezone_options/" \
  -H "x-hookpulse-api-key: {{x-hookpulse-api-key}}" \
  -H "x-brand-uuid: {{x-brand-uuid}}"

{
  "data": [
    {
      "label": "Africa/Abidjan",
      "value": "Africa/Abidjan"
    },
    {
      "label": "Africa/Accra",
      "value": "Africa/Accra"
    },
    {
      "label": "America/New_York",
      "value": "America/New_York"
    },
    {
      "label": "Asia/Kolkata",
      "value": "Asia/Kolkata"
    },
    {
      "label": "Europe/London",
      "value": "Europe/London"
    },
    {
      "label": "Pacific/Auckland",
      "value": "Pacific/Auckland"
    }
  ],
  "success": true
}
Retrieve a complete list of all available IANA timezones supported by HookPulse. This endpoint returns all 500+ timezones that can be used in cron, clocked, and solar schedules.

​
Base URL

All API requests should be made to: 
https://api.hookpulse.io

​
Example request

curl -X GET "https://api.hookpulse.io/v1/api/timezone_options/" \
  -H "x-hookpulse-api-key: {{x-hookpulse-api-key}}" \
  -H "x-brand-uuid: {{x-brand-uuid}}"

​
Example response

{
  "data": [
    {
      "label": "Africa/Abidjan",
      "value": "Africa/Abidjan"
    },
    {
      "label": "Africa/Accra",
      "value": "Africa/Accra"
    },
    {
      "label": "America/New_York",
      "value": "America/New_York"
    },
    {
      "label": "Asia/Kolkata",
      "value": "Asia/Kolkata"
    },
    {
      "label": "Europe/London",
      "value": "Europe/London"
    },
    {
      "label": "Pacific/Auckland",
      "value": "Pacific/Auckland"
    }
  ],
  "success": true
}

​
Response fields

​
Data array

FieldTypeDescription
labelstringHuman-readable timezone label (same as value)
valuestringIANA timezone identifier to use in schedule requests

​
Root fields

FieldTypeDescription
successbooleanIndicates if the request was successful
dataarrayArray of timezone objects (500+ timezones)

​
Usage

Use the value field from the response when creating schedules that require timezone specification:
  • Cron Schedules: Use in cron_timezone field
  • Clocked Schedules: Use in clocked_timezone field
  • Solar Schedules: Timezone is calculated based on coordinates

​
Timezone Coverage

HookPulse supports the complete IANA Time Zone Database, including:
  • All continents: Africa, America, Antarctica, Arctic, Asia, Atlantic, Australia, Europe, Indian, Pacific
  • 500+ timezones: Complete coverage of all recognized timezones
  • Automatic DST handling: Daylight Saving Time transitions are handled automatically
  • Historical accuracy: Accurate timezone data for past and future dates

​
Common Timezones

Popular timezones you might use:
  • America/New_York - Eastern Time (US)
  • America/Chicago - Central Time (US)
  • America/Denver - Mountain Time (US)
  • America/Los_Angeles - Pacific Time (US)
  • Europe/London - Greenwich Mean Time / British Summer Time
  • Europe/Paris - Central European Time
  • Asia/Kolkata - India Standard Time
  • Asia/Tokyo - Japan Standard Time
  • Australia/Sydney - Australian Eastern Time
  • UTC - Coordinated Universal Time

Authorizations

​
x-hookpulse-api-key
string
header
required

API key for authentication. Get this from your dashboard by selecting a brand and going to API Keys section.

​
x-brand-uuid
string
header
required

Brand UUID for authentication. Get this from your dashboard after adding a brand - it will be displayed in the UI.

Response

200 - application/json

Successful response with list of timezones

​
data
object[]

Array of timezone options

​
success
boolean

Indicates if the request was successful