# fittings Timezone Offset Lookup

> fittings Timezone Offset Lookup is a paid API for AI agents from fittings.sh, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Returns the UTC offset, timezone abbreviation, and DST state for an IANA timezone at a specific moment, including surrounding DST transitions and resolution of ambiguous or nonexistent local times.

## Facts

- Endpoint: GET https://fittings.sh/v1/tz/offset-at
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fittings-timezone-offset-lookup-3550ecce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sk_nDyM5WF7HW8V2NVbo1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fittings-timezone-offset-lookup-3550ecce
```

Example prompt: What UTC offset and timezone abbreviation was America/New_York using on 2024-03-10T07:00:00Z — was it on DST, and what were the surrounding transition times?

## When to prefer this

Use this endpoint when you need precise UTC offset, DST state, or timezone abbreviation for a specific IANA zone at an exact historical or future moment — especially when handling ambiguous fall-back or nonexistent spring-forward local times. Prefer this over simple offset tables or language-library lookups when accuracy around DST transitions is critical or when you need the surrounding transition boundaries explicitly returned.

## Known failure modes

- Invalid or unknown IANA timezone name returns an error
- Malformed ISO 8601 instant string returns a parse error
- Providing neither instant nor localTime returns a validation error
- Providing both instant and localTime simultaneously may return an error or prefer one over the other
- Instants before 1970 may not be supported or may return limited data

## How this service works

The UTC offset, abbreviation and DST state a zone was on at any moment from 1970, with the surrounding transitions, and resolution of ambiguous or nonexistent local times.

## Output

Returns the UTC offset in seconds or hours, the timezone abbreviation (e.g. EST, CEST), whether DST was active, the start and end instants of the surrounding DST transitions, and resolution details for ambiguous or nonexistent local times.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "timezone"
     ],
     "properties": {
      "instant": {
       "type": "string",
       "description": "ISO 8601 with an explicit Z or +HH:MM offset. Give this or localTime."
      },
      "timezone": {
       "type": "string",
       "description": "IANA zone, e.g. America/New_York"
      },
      "localTime": {
       "type": "string",
       "description": "Wall-clock time with no offset, e.g. 2026-11-01T01:30:00. Give this or instant."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fittings-timezone-offset-lookup-3550ecce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fittings.sh](https://www.zero.xyz/host/fittings.sh/llms.txt)