{"uid":"cap_jzFs0nCt1hTv1C5r5aDwA","slug":"2s-timezone-lookup-by-coordinates-39e58b27","name":"2s Timezone Lookup by Coordinates","description":"Resolve a coordinate to its IANA timezone and return the current UTC offset, local wall time, DST status, and short abbreviation. Query: lat (-90..90), lon (-180..180), at (optional ISO 8601 instant; defaults to now). Returns { tz, abbreviation, offsetMinutes, offsetHours, localTime, observesDst, isDst, januaryOffsetMinutes, julyOffsetMinutes, instant, source }. Polygon lookup against a CC0 timezone boundary index; offsets and DST come from the runtime tzdata so transition rules stay current. Use when scheduling for a coordinate, converting timestamps to local wall time, or checking whether a location is currently observing daylight saving.","url":"https://2s.io/api/timezone/lookup","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["lat","lon"],"properties":{"at":{"type":"string","description":"Optional ISO 8601 instant. Defaults to the current server time."},"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude in degrees, -90..90."},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude in degrees, -180..180."}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"lat":40.7128,"lon":-74.006}}},"response":{"data":{"ok":true,"items":[{"tz":"America/New_York","isDst":true,"instant":"2026-06-12T05:08:01.340Z","localTime":"2026-06-12T01:08:01-04:00","observesDst":true,"offsetHours":-4,"abbreviation":"EDT","offsetMinutes":-240,"julyOffsetMinutes":-240,"januaryOffsetMinutes":-300}],"total":1,"source":{"url":"https://github.com/darkskyapp/tz-lookup","license":"CC0 (polygon index) + Public domain (tzdata)","provider":"tz-lookup + IANA tzdata (computed locally)"}},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"timezone.lookup","settlement":{"txHash":"0x1f3edb5627edd37e499f914e6f6caeba07fb3a2fa1e543d592fbb46290703a6c","network":"eip155:8453","success":true}}}},"exampleRequest":{"lat":40.7128,"lon":-74.006},"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1xJB6RZrOQV-wDnemQbiQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","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 identifier, UTC offset, local wall time, and DST status for a given latitude/longitude coordinate, optionally at a specified instant in time.","exampleAgentPrompt":"What timezone is the location at latitude 48.8566, longitude 2.3522? I need the IANA name, current UTC offset, local time, and whether DST is active right now.","exampleUseCases":null,"resultDescription":"A JSON object containing an array of timezone records for the given coordinates, each with the IANA timezone ID (e.g. 'America/Los_Angeles'), short abbreviation (e.g. 'PDT'), UTC offset in both hours and minutes, ISO 8601 local wall time with offset suffix, DST observance flags, and representative January/July offsets for the year. Also includes source/provider attribution.","failureModes":["Missing required lat or lon parameter returns a validation error","lat out of range (-90 to 90) or lon out of range (-180 to 180) returns a validation error","Invalid ISO 8601 format for optional 'at' parameter returns a parse error","Payment not provided or insufficient USDC balance returns HTTP 402","Coordinates in international waters or uninhabited regions may return no timezone items"],"whenToPreferThis":"Use this endpoint when you need to resolve a geographic coordinate (lat/lon) to its IANA timezone identifier and current UTC offset without signing up for a separate API key or managing a subscription. It's ideal for AI agents that need pay-per-call, no-auth timezone resolution embedded in a geospatial or scheduling workflow, especially when you also need DST awareness and local wall time at a specific instant.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:51:09.539Z","isFirstParty":false}