Get Timezones

GET/web/v1/system/constants/timezones None

Required Gateway Headers

All API requests require gateway headers. See Required Headers for the complete list. In local/test environments, you must also include Cloudflare simulation headers (CF-Connecting-IP, Cf-Ray, cf-ipcountry).

Returns a list of all supported timezones with IANA zone IDs and UTC offsets. The response is localized based on the Accept-Language request header.

Authentication

No authentication required. This is a public endpoint.

Request Parameters

None.

Success Response

Success 200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": [
    {
      "code": "ASIA_SHANGHAI",
      "value": 95010102,
      "label": "Shanghai",
      "description": "Asia/Shanghai timezone (UTC+8)",
      "zoneIdCode": "Asia/Shanghai",
      "utcOffset": "UTC+8"
    },
    {
      "code": "AMERICA_NEW_YORK",
      "value": 95010103,
      "label": "New York",
      "description": "America/New_York timezone (UTC-5)",
      "zoneIdCode": "America/New_York",
      "utcOffset": "UTC-5"
    }
  ]
}

Response Fields

Name	Type	Required	Description
code	string	Required	Enum name identifier (e.g., "ASIA_SHANGHAI")
value	integer	Required	8-digit numeric code for API usage
label	string	Required	Localized display name based on Accept-Language header
description	string	Required	Localized human-readable description of the timezone
zoneIdCode	string	Required	IANA timezone identifier (e.g., "Asia/Shanghai")
utcOffset	string	Required	UTC offset string (e.g., "UTC+8")

Error Responses

HTTP Status	Code	Message	Description
500	"5000"	"INTERNAL_SERVER_ERROR"	Unexpected server error

Notes

• The label field is localized; send Accept-Language: zh-CN for Chinese labels.