{"uid":"cap_soF4vH-BZAW37Dj-b7axB","slug":"agent-time-place-timezone-lookup-b6c3624e","name":"Agent Time & Place – Timezone Lookup","description":"Geocoding, timezones, holidays, business days, sun times, FX and distances for AI agents. Deterministic, sub-cent, no API key: payment is authentication (x402).","url":"https://time-place.agent-utils.workers.dev/v1/timezone","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"at":{"type":"string","format":"date-time","description":"Optional ISO instant to evaluate offset/DST at (default now)"},"tz":{"type":"string","description":"IANA timezone id (alternative to lat/lon/city)"},"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude in decimal degrees (WGS84)"},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude in decimal degrees (WGS84)"},"city":{"type":"string","description":"City name (alternative to lat/lon)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"isDst":{"type":"boolean"},"place":{"type":["object","null"]},"utcTime":{"type":"string"},"timezone":{"type":"string"},"localTime":{"type":"string"},"utcOffset":{"type":"string"},"observesDst":{"type":"boolean"},"abbreviation":{"type":"string"},"resolvedFrom":{"enum":["coordinates","city","tz"],"type":"string"},"utcOffsetMinutes":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"isDst":false,"place":{"name":"Tokyo","country":"JP"},"utcTime":"2026-09-06T14:15:04.000Z","timezone":"Asia/Tokyo","localTime":"2026-09-06T23:15:04+09:00","utcOffset":"+09:00","observesDst":false,"abbreviation":"GMT+9","resolvedFrom":"city","utcOffsetMinutes":540}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WrwDtq79Nk5TNJqIwhAzi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the IANA timezone, UTC offset, DST status, local time, and abbreviated name for a given location (coordinates, city name, or IANA timezone ID).","exampleAgentPrompt":"What IANA timezone and current UTC offset apply to Tokyo — and is it currently observing daylight saving time?","exampleUseCases":[{"title":"Scheduling across international time zones","prompt":"I need to schedule a meeting with someone in São Paulo, Brazil — what's their IANA timezone and current UTC offset so I can figure out the right time?"},{"title":"Localizing timestamps for a user's city","prompt":"The user says they're in Berlin — what's the current local time and timezone abbreviation there so I can display their dashboard in local time?"},{"title":"Verifying DST status before a deadline","prompt":"Is San Francisco currently on daylight saving time, and what's the exact UTC offset right now? I need to know before I set a deadline."}],"resultDescription":"A JSON object containing the IANA timezone string (e.g. 'Asia/Tokyo'), current local ISO 8601 datetime, UTC time, UTC offset string (e.g. '+09:00'), UTC offset in integer minutes, boolean flags for whether DST is currently active and whether the zone observes DST at all, the short abbreviation (e.g. 'GMT+9'), how the location was resolved ('coordinates', 'city', or 'tz'), and optionally a place object with city name and country code.","failureModes":["Missing or ambiguous city name returns an error or resolves to an unintended location","Coordinates outside valid WGS84 range (-90 to 90 lat, -180 to 180 lon) are rejected","Invalid or unrecognized IANA timezone ID causes a lookup failure","Payment not provided or insufficient USDC causes a 402 response blocking access","If 'at' parameter is omitted, offset is evaluated at server-side 'now', which may differ from the caller's intended moment"],"whenToPreferThis":"Choose this endpoint when an AI agent needs authoritative, deterministic timezone metadata — IANA ID, UTC offset, DST status — for a given place or coordinate pair, without the overhead of managing API keys. Ideal for scheduling, datetime localization, and time-aware workflows. Prefer over manual TZ databases or geocoding-bundled APIs when sub-cent, pay-per-call pricing and no-key-required access via x402 are advantageous.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:45:10.051Z","isFirstParty":false}