{"uid":"cap_pb2z88dU_rhbK0cab3P6Y","slug":"timezone-lookup-by-iana-name-5f68b147","name":"Timezone Lookup by IANA Name","description":"Look up a timezone by IANA name and return its current UTC offset, DST state and local time. Pure CPU, instant.","url":"https://api.gadgethumans.com/timezone?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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}}}}},"responseSchema":{"type":"json","example":{"ok":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-kAMKSOP0Q7jm0mBos9cH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current UTC offset, DST status, and local time for a given IANA timezone name.","exampleAgentPrompt":"What's the current UTC offset and local time for America/Chicago, and is it currently observing daylight saving time?","exampleUseCases":[{"title":"Scheduling cross-timezone meeting","prompt":"I need to schedule a call with someone in Europe/Berlin — what's their current UTC offset and local time right now so I can figure out a good overlap with my 9am Pacific?"},{"title":"DST-aware reminder system","prompt":"Before I send this calendar invite, check if America/Denver is currently on daylight saving time and what its UTC offset is so the time displays correctly for people there."},{"title":"Validating timezone in user profile","prompt":"A user just set their timezone to Asia/Kolkata in their profile — can you confirm that's a valid IANA timezone and tell me its current UTC offset and local time?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:40:20.650Z","isFirstParty":false,"canonicalSlug":"timezone-lookup-by-iana-name-5f68b147"}