Timezones

The Timezones API allows you to retrieve a list of all available timezones supported by Pipeback. This endpoint is crucial for scheduling, time-based automation, and international operations.

The Timezone Object

Name
id
Type
uuid
Description
Unique identifier for the timezone.
Name
value
Type
string
Description
IANA timezone database identifier (e.g., America/New_York, Europe/London, America/Sao_Paulo, UTC).
Name
title
Type
string
Description
Human-readable timezone name with UTC offset (e.g., (UTC-05:00) America/New_York, (UTC+00:00) Europe/London).

GET/app/timezones

List All Timezones

This endpoint returns a list of all available timezones supported by Pipeback, ordered alphabetically by title.

This endpoint requires authentication with both Authorization and x-workspace-id headers.

Request

GET

/app/timezones

curl https://api.pipeback.com/app/timezones \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "x-workspace-id: YOUR_WORKSPACE_ID"

Response

{
  "data": [
    {
      "id": "9d5f3d04-4d81-6f3c-0c5g-3d4e5f6g7h8a",
      "value": "Africa/Abidjan",
      "title": "(UTC+00:00) Africa/Abidjan"
    },
    {
      "id": "9d5f3d04-4d81-6f3c-0c5g-3d4e5f6g7h8b",
      "value": "America/New_York",
      "title": "(UTC-05:00) America/New_York"
    },
    {
      "id": "9d5f3d04-4d81-6f3c-0c5g-3d4e5f6g7h8c",
      "value": "America/Sao_Paulo",
      "title": "(UTC-03:00) America/Sao_Paulo"
    },
    {
      "id": "9d5f3d04-4d81-6f3c-0c5g-3d4e5f6g7h8d",
      "value": "Asia/Tokyo",
      "title": "(UTC+09:00) Asia/Tokyo"
    },
    {
      "id": "9d5f3d04-4d81-6f3c-0c5g-3d4e5f6g7h8e",
      "value": "Europe/London",
      "title": "(UTC+00:00) Europe/London"
    },
    {
      "id": "9d5f3d04-4d81-6f3c-0c5g-3d4e5f6g7h8f",
      "value": "UTC",
      "title": "(UTC+00:00) UTC"
    }
  ]
}

Timezone Format

All timezones follow the IANA Time Zone Database standard (also known as the tz database or Olson database). This ensures accurate handling of:

Daylight Saving Time (DST) transitions
Historical timezone changes
Regional variations

The title field includes the UTC offset to help users quickly identify timezone differences, while the value field contains the canonical IANA identifier for programmatic use.