How to convert a time between time zones with an API
Updated 2026-11-10
Use when an agent must convert one moment to the local time in several time zones, with DST offsets.
From an MCP client, add https://tanod.dev/mcp and call convert_time; its free daily calls are applied automatically, no key or signup.
POST a time and a list of zones to /v1/time. It returns the UTC time, Unix seconds and one conversion per zone with the local time, UTC offset, abbreviation and a DST flag.
Request
to_tz is 1 to 20 IANA zones such as America/New_York. time is ISO 8601 or Unix seconds, and defaults to now. from_tz names the zone of a time written without an offset (default UTC); a time with an offset plus from_tz is a 422.
curl -s -X POST https://tanod.dev/v1/time \
-H 'X-Tanod-Free: 1' -H 'content-type: application/json' \
-d '{"time": "2026-10-07T09:30:00Z", "to_tz": ["America/New_York", "Europe/Berlin"]}'Response
{
"utc": "2026-10-07T09:30:00Z",
"unix": 1791365400,
"input": {
"time": "2026-10-07T09:30:00+00:00",
"date": "2026-10-07",
"weekday": "Wednesday",
"utc_offset": "+00:00",
"utc_offset_seconds": 0,
"ambiguous": false,
"nonexistent": false
},
"conversions": [
{
"timezone": "America/New_York",
"time": "2026-10-07T05:30:00-04:00",
"date": "2026-10-07",
"weekday": "Wednesday",
"utc_offset": "-04:00",
"utc_offset_seconds": -14400,
"abbreviation": "EDT",
"dst": true
},
{
"timezone": "Europe/Berlin",
"time": "2026-10-07T11:30:00+02:00",
"date": "2026-10-07",
"weekday": "Wednesday",
"utc_offset": "+02:00",
"utc_offset_seconds": 7200,
"abbreviation": "CEST",
"dst": true
}
],
"source": {
"library": "Python zoneinfo + tzdata",
"tzdata": "2026e",
"license": "Apache-2.0 (tzdata package); the IANA tz database is public doma…",
"url": "https://www.iana.org/time-zones"
}
}Limits and caveats
A local time that does not exist, or occurs twice, on a clock-change day is flagged nonexistent or ambiguous in input. Check these flags before you rely on the result.
Zones come from a pinned IANA tz database release (shown as tzdata in the response), not the host's. Rule changes announced after that release are not included, and abbreviations like IST (used for India, Ireland and Israel) are the database's own labels, not a legal standard.
Price and free allowance
USD 0.001 per call, paid in USDC on Base, Polygon, Solana, BNB Chain or Arbitrum with x402. 10 free calls per IP per UTC day with the header X-Tanod-Free: 1. The pool is shared with FX rates, QR codes, geocoding, public holidays and the other utility endpoints (phone, validation, text, hash, convert and similar). MCP tool: convert_time at https://tanod.dev/mcp, where the free tier is automatic.
Use it from Claude without writing code: in claude.ai or Claude Desktop, add https://tanod.dev/mcp/util?via=timezone-converter-api as a custom connector (steps), then ask in plain words, for example "What is 9 am in New York in Berlin, London and Tokyo on 15 March 2026?" The free daily allowance is applied automatically over MCP. Beyond it a call needs an x402 payment, which these clients can make.
Related guides: How to get the next run times of a cron expression with an API, Public holidays API, Weather forecast API without an API key. Back to tanod.dev or the guide index. Results are automated and heuristic.