{"uid":"cap_Z77FL9Bgg9bJZWqjLgOii","slug":"api-x402node-dev-4adae4df","name":"Timezone Lookup by Coordinate","description":"Timezone lookup for a coordinate via timeapi.io. Returns IANA timezone, current local time, UTC offset, DST status. Use ?lat=37.78 and lng=-122.42. Built for AI agents scheduling across regions. Accepts payment on Base or Solana — either network works.","url":"https://api.x402node.dev/maps/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":{"lat":{"type":"string","description":"Lat (optional)"},"lng":{"type":"string","description":"Lng (optional)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"lat":37.7749,"lng":-122.4194},"response":{"lat":37.7749,"lng":-122.4194,"_hint":"x402 paid endpoints for AI agents — x402node.dev (utilities) · cn402.com (Chinese culture)","has_dst":true,"timezone":"America/Los_Angeles","is_dst_active":true,"current_local_time":"2026-06-17T22:20:49.6607833","current_utc_offset_seconds":-25200,"standard_utc_offset_seconds":-28800}},"exampleRequest":{"lat":37.7749,"lng":-122.4194},"tags":["x402"],"displayCostAmount":"0.0022","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0022/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0022","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0022","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_v3aAi9qOMel-VRCHL4Wsy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0022","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns IANA timezone name, current local time, UTC offset, and DST status for a given latitude/longitude coordinate pair.","exampleAgentPrompt":"What timezone is at coordinates 37.78 latitude, -122.42 longitude — I need the IANA name, current local time, UTC offset, and whether DST is active right now.","exampleUseCases":[{"title":"Schedule meeting across global offices","prompt":"I have team members at these GPS coordinates from our HR system — can you look up the local timezone and current time for each location so I can find a meeting slot that works for everyone without anyone having to work outside business hours?"},{"title":"Verify delivery window for field technician","prompt":"Our field technician just checked in at 51.5074° N, -0.1278° W — what's the local time there right now and is daylight saving time active? I need to confirm whether the 3pm delivery window still applies or if we need to adjust."},{"title":"Convert GPS log timestamps to local time","prompt":"I have a bunch of GPS coordinates from our fleet tracker and I need to know the exact local time and timezone at each stop — can you pull the IANA timezone name and UTC offset for coordinates 48.8566 latitude, 2.3522 longitude so I can start converting the timestamps in our logs?"}],"resultDescription":"Returns an object containing the IANA timezone identifier (e.g. 'America/Los_Angeles'), the current local time at that location, the UTC offset in hours, and a boolean or flag indicating whether daylight saving time is currently in effect.","failureModes":["Invalid or out-of-range latitude/longitude values return an error","Coordinates over open ocean or uninhabited areas may return unexpected or null timezone data","Upstream timeapi.io outage causes request failure","Missing lat/lng parameters result in a 400-level error","Payment not included or insufficient USDC causes x402 payment required error"],"whenToPreferThis":"Use this endpoint when you need authoritative IANA timezone data for a specific geographic coordinate, especially for AI agent workflows that need to schedule events or convert times across regions without maintaining a local timezone database. It is ideal when you have a lat/lng and need both the timezone name and real-time local clock info in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:02:19.198Z","isFirstParty":false}