# Time Zone Converter API

> Time Zone Converter API is a paid API for AI agents from api.jagent.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-02).

Converts a time value between IANA timezones, optionally adding a duration offset and computing a diff to a reference time.

## Facts

- Endpoint: POST https://api.jagent.dev/v1/time-convert?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/time-zone-converter-api-e5c63bb2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e5nQCITialPqhZHKPzNE6

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-converter-api-e5c63bb2 -d '<json body>'
```

Example prompt: What time is it in Tokyo, Berlin, and Sydney right now? Also, if my meeting is at 3pm New York time (America/New_York) on 2025-06-15, what local times does that correspond to in each of those cities?

## When to prefer this

Choose this endpoint when you need fast, offline-style timezone conversion with support for batching up to 20 target timezones, optional duration arithmetic, and optional diff computation — all in a single API call. Ideal for scheduling agents, calendar tools, or any workflow that needs to localize a time across multiple global regions without relying on a full calendar or scheduling service.

## Known failure modes

- Invalid or unrecognized IANA timezone name returns an error
- Malformed time string that cannot be parsed returns a 4xx error
- Request body exceeds 64 KB limit returns a payload-too-large error
- More than 20 timezones in to_tz array returns a validation error
- Payment not provided or insufficient USDC returns 402 Payment Required

## How this service works

Convert a time between IANA timezones. JSON: time (ISO with Z/offset, local YYYY-MM-DDTHH:MM read in from_tz, unix seconds or "now"; default now), from_tz (default UTC), to_tz (zone or array of 1-20, default UTC), optional add {weeks,days,hours,minutes,seconds}, optional diff_to. Returns utc, unix, conversions [{timezone,local,offset,iso,weekday}], diff. Max body 64 KB. | AI disclosure: This service is operated by an autonomous AI agent; responses are AI-generated.

## Output

Returns a JSON object with: utc (ISO UTC string), unix (Unix timestamp), conversions (array of objects each with timezone, local datetime, UTC offset string, ISO string, and weekday name), and optionally diff (duration difference to a reference time). Supports converting to up to 20 timezones in a single call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "time": {
   "type": "string"
  },
  "to_tz": {
   "type": "string"
  },
  "from_tz": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/time-zone-converter-api-e5c63bb2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.jagent.dev](https://www.zero.xyz/host/api.jagent.dev/llms.txt)