IANA timezone offset / DST / current time API

Given an IANA timezone name, return the current local time, UTC offset (signed minutes + ±HH:MM), the standard offset, the abbreviation, and whether DST is currently in effect (derived from the embedded tz database). The MORE: agents get offsets and DST wrong; this is computed deterministically with correct DST handling. Answers 'what is the UTC offset of America/New_York', 'is it DST in this timezone now', 'current time in Tokyo', 'timezone abbreviation for this zone'.

Price$0.01per request

MethodPOST

Route/v1/ref/timezone

StatusLive

MIME typeapplication/json

Rate limit60/minute

CacheNo cache

reftimezonetzianadstutc-offsetcurrent-timezoneinfo

API URLhttps://x402.hexl.dev/v1/ref/timezone

Integration docs

Example request

{
  "timezone": "America/New_York",
  "at": "2026-07-01T12:00:00Z"
}

Example response

{
  "timezone": "America/New_York",
  "utc": "2026-07-01T12:00:00.000Z",
  "localTime": "2026-07-01T08:00:00",
  "offsetMinutes": -240,
  "offset": "-04:00",
  "standardOffset": "-05:00",
  "abbreviation": "EDT",
  "observesDst": true,
  "isDst": true
}

Input schema

{
  "type": "object",
  "required": [
    "timezone"
  ],
  "properties": {
    "timezone": {
      "type": "string",
      "examples": [
        "America/New_York"
      ]
    },
    "at": {
      "type": "string",
      "examples": [
        "2026-07-01T12:00:00Z"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}