# Time Zone Directory

> Time Zone Directory is a paid API for AI agents from flat-rate-llm.kikoribera03.workers.dev, paid per call via x402, $0.0025/call, status unknown (last checked 2026-09-14).

Search the full IANA time zone list to get each zone's current UTC offset, abbreviation, local time, and DST state, or find zones matching a city, country, or offset.

## Facts

- Endpoint: POST https://flat-rate-llm.kikoribera03.workers.dev/v1/time/zones
- Price: $0.0025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/time-zone-directory-7858ee74
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_elOKC-MkHYwLArAyCdbYv

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 time-zone-directory-7858ee74 -d '<json body>'
```

Example prompt: What IANA time zone name should I use for São Paulo, and what is its current UTC offset and DST status?

## When to prefer this

Use this endpoint when you need to translate a human-readable location (city, country) or a numeric UTC offset into a valid IANA time zone name required by other endpoints, or when you need to enumerate all zones at a specific offset. Prefer this over a 'current time' endpoint when the goal is discovery or validation of zone names rather than fetching the actual current time for a known zone.

## Known failure modes

- No matching zones found for the given city or country — returns empty list or 404
- Invalid offset format provided — returns 400 bad request
- Ambiguous city name matching multiple zones — may return multiple results requiring disambiguation
- Service temporarily unavailable — upstream Workers failure returns 5xx

## How this service works

60 paid endpoints with no metering, no API key and no account. Each endpoint has one flat price per call, whatever the size of the request: LLM completions with automatic failover across several large models, read-only EVM tooling over Base, Ethereum, Polygon, Arbitrum and Optimism, and pure crypto utilities that touch no network.

## Output

Returns a list of matching IANA time zone entries, each including the canonical zone name, current UTC offset (e.g. +05:30), time zone abbreviation (e.g. IST), current local time, and whether DST is currently active — giving the agent everything needed to pass the correct zone identifier to downstream endpoints.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "description": "Maximum zones returned, 1-500. Defaults to 50."
  },
  "offset": {
   "type": "string",
   "description": "Keep only zones at this current UTC offset, e.g. \"+09:00\" or \"-5\"."
  },
  "search": {
   "type": "string",
   "description": "Substring matched against the zone name, case-insensitive. Omit to list them all."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "total": {
   "type": "number"
  },
  "zones": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "matched": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/time-zone-directory-7858ee74/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from flat-rate-llm.kikoribera03.workers.dev](https://www.zero.xyz/host/flat-rate-llm.kikoribera03.workers.dev/llms.txt)