{"uid":"cap_dfddhmJVCX1gydhDg770e","slug":"duo-data-utilities-dst-transitions-d0a25e5a","name":"Duo Data Utilities – DST Transitions","description":"List the daylight-saving transitions for an IANA time zone over a date range: the exact instant of each shift, the offset before and after, and whether local clocks jump forward or back. Returns the current offset and DST state, and the next transition from a given instant. Zones without DST return an empty transition list rather than an error.","url":"https://api.duoleads.com/v1/time/dst?utm_source=zero.xyz","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","required":["zone"],"properties":{"from":{"type":"string","maxLength":64,"description":"Start of the range: RFC 3339 or YYYY-MM-DD. Default now."},"zone":{"type":"string","maxLength":64,"description":"IANA time zone id."},"years":{"type":"string","default":"2","pattern":"^[+-]?\\d+$","maxLength":64,"description":"Length of the range in years, 1-10. Default 2."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","route","version","data","meta"],"properties":{"ok":{"const":true},"data":{"type":"object","required":["zone","observes_dst","current","next","transitions"],"properties":{"next":{"type":["object","null"],"required":["at","local_before","local_after","offset_before","offset_after","delta_seconds","direction","abbreviation_before","abbreviation_after"],"properties":{"at":{"type":"string"},"direction":{"type":"string"},"local_after":{"type":"string"},"local_before":{"type":"string"},"offset_after":{"type":"string"},"delta_seconds":{"type":"integer"},"offset_before":{"type":"string"},"abbreviation_after":{"type":"string"},"abbreviation_before":{"type":"string"}}},"zone":{"type":"string"},"current":{"type":"object","required":["offset","offset_seconds","abbreviation","dst"],"properties":{"dst":{"type":"boolean"},"offset":{"type":"string"},"abbreviation":{"type":"string"},"offset_seconds":{"type":"integer"}}},"transitions":{"type":"array","items":{"type":"object","required":["at","local_before","local_after","offset_before","offset_after","delta_seconds","direction","abbreviation_before","abbreviation_after"],"properties":{"at":{"type":"string"},"direction":{"type":"string"},"local_after":{"type":"string"},"local_before":{"type":"string"},"offset_after":{"type":"string"},"delta_seconds":{"type":"integer"},"offset_before":{"type":"string"},"abbreviation_after":{"type":"string"},"abbreviation_before":{"type":"string"}}}},"observes_dst":{"type":"boolean"}}},"meta":{"type":"object","required":["request_id","computed_at","price_usd","deterministic","disclaimer"],"properties":{"sources":{"type":"array","items":{"type":"object","required":["id","version","published"]}},"price_usd":{"type":"string"},"disclaimer":{"type":"string"},"request_id":{"type":"string"},"computed_at":{"type":"string","description":"RFC 3339 UTC with milliseconds"},"deterministic":{"type":"boolean"}}},"route":{"const":"/v1/time/dst"},"version":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"next":{"at":"2026-03-29T01:00:00.000Z","direction":"forward","local_after":"2026-03-29T03:00:00","local_before":"2026-03-29T01:59:59","offset_after":"+02:00","delta_seconds":3600,"offset_before":"+01:00","abbreviation_after":"GMT+2","abbreviation_before":"GMT+1"},"zone":"Europe/Amsterdam","current":{"dst":false,"offset":"+01:00","abbreviation":"GMT+1","offset_seconds":3600},"transitions":[{"at":"2026-03-29T01:00:00.000Z","direction":"forward","local_after":"2026-03-29T03:00:00","local_before":"2026-03-29T01:59:59","offset_after":"+02:00","delta_seconds":3600,"offset_before":"+01:00","abbreviation_after":"GMT+2","abbreviation_before":"GMT+1"},{"at":"2026-10-25T01:00:00.000Z","direction":"back","local_after":"2026-10-25T02:00:00","local_before":"2026-10-25T02:59:59","offset_after":"+01:00","delta_seconds":-3600,"offset_before":"+02:00","abbreviation_after":"GMT+1","abbreviation_before":"GMT+2"}],"observes_dst":true},"meta":{"price_usd":"0.05","disclaimer":"Factual output of a deterministic computation over public data. Provided as is, with no warranty of accuracy, completeness or availability. Not investment, financial, legal, tax, medical or any other professional advice, and not a recommendation. Verify before relying on it. Terms: https://api.duoleads.com/terms","request_id":"01K6B7Q4ZC8H3F2M9WXR5TYN0D","computed_at":"2026-09-28T12:00:00.000Z","deterministic":true},"route":"/v1/time/dst","version":"1.0.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DH5LEDKYSnMOTfNnsxEGf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Lists daylight-saving time transitions for an IANA time zone over a date range, returning the exact shift instants, UTC offsets before/after, direction, and current DST state.","exampleAgentPrompt":"What are all the DST transitions for Europe/Amsterdam over the next two years starting from today — give me the exact moment each shift happens, the offsets before and after, and whether clocks jump forward or back?","exampleUseCases":[{"title":"Scheduling across time zones","prompt":"I'm planning recurring meetings with a team in London starting March 1 2026 — can you list all the daylight saving transitions for Europe/London over the next two years so I know exactly when the offset changes and by how much?"},{"title":"Checking if a region observes DST","prompt":"Does America/Phoenix ever observe daylight saving time? List any DST transitions for that zone over the next two years starting now."},{"title":"Finding the next clock change","prompt":"When is the next time clocks change in America/New_York from today, and will they go forward or back? What will the UTC offset be after the transition?"}],"resultDescription":"A JSON object containing: the IANA zone name, whether it observes DST, the current offset and DST state, the next upcoming transition (with exact UTC instant, local times before/after, offsets before/after, abbreviations, and delta in seconds), and a full list of transitions over the requested date range. Zones without DST return an empty transitions array and observes_dst: false.","failureModes":["Invalid or unknown IANA time zone ID returns an error rather than an empty response","Invalid date format for 'from' parameter causes a validation error","Years parameter outside the 1-10 range may be rejected","Malformed query parameters return HTTP 400","Payment not included or insufficient triggers HTTP 402"],"whenToPreferThis":"Choose this endpoint when you need precise, structured DST transition data for any IANA time zone — including exact UTC instants of shifts, offsets before and after, and the direction of change. Prefer it over manual timezone libraries when operating in an agent environment without native TZ database access, or when you need a deterministic, auditable, API-delivered answer with pricing metadata. Well-suited for scheduling agents, calendar tools, and internationalization workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:45:16.612Z","isFirstParty":false,"canonicalSlug":"duo-data-utilities-dst-transitions-d0a25e5a"}