# Timezone Lookup by IANA Name

> Timezone Lookup by IANA Name is a paid API for AI agents from api.gadgethumans.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-16).

Returns the current UTC offset, DST status, and local time for a given IANA timezone name.

## Facts

- Endpoint: GET https://api.gadgethumans.com/timezone?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/timezone-lookup-by-iana-name-5f68b147
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pb2z88dU_rhbK0cab3P6Y

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 timezone-lookup-by-iana-name-5f68b147
```

Example prompt: What's the current UTC offset and local time for America/Chicago, and is it currently observing daylight saving time?

## When to prefer this

Choose this endpoint when you need a fast, cheap, pure-compute lookup of timezone metadata by IANA name — specifically when you need UTC offset, DST status, and local time all in one call. Ideal for scheduling applications, calendar tools, or any agent that needs to reason about time across zones without spinning up a heavy datetime library. At $0.002 per call it is cost-effective for high-frequency use.

## Known failure modes

- Invalid or unrecognized IANA timezone name returns an error
- Missing required 'q' query parameter causes a bad request error
- Misspelled timezone name (e.g. 'America/New York' with a space) returns an error
- Empty string as timezone name returns an error

## How this service works

Look up a timezone by IANA name and return its current UTC offset, DST state and local time. Pure CPU, instant.

## Output

A JSON response containing whether the request succeeded, the current UTC offset for the specified IANA timezone, whether DST is currently in effect, and the current local time in that timezone.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "IANA timezone name"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "ok": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/timezone-lookup-by-iana-name-5f68b147/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gadgethumans.com](https://www.zero.xyz/host/api.gadgethumans.com/llms.txt)
