{"uid":"cap_OgrztEQorlsPjFypg99jY","slug":"1gateway-time-zone-overlap-finder-76f47221","name":"1gateway Time Zone Overlap Finder","description":"Use when scheduling a meeting across time zones. Input: zones (2-10, IANA or KST/PST/CET), date, work_start/work_end (default 09:00-18:00), include_weekends. Output: JSON overlap windows in UTC and every zone's local time, top 3 one-hour slots ranked by distance from each zone's day edges, partial windows when no full overlap, next DST change per zone. Example: ?zones=America/New_York,Europe/London,Asia/Seoul&date=2026-11-03","url":"https://1gateway.dev/v1/time/overlap?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":["zones"],"properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","examples":["2026-11-03"],"description":"Meeting date YYYY-MM-DD in the anchor zone (default today UTC)"},"zones":{"type":"string","pattern":"^[A-Za-z0-9_+\\-/]+(\\s*,\\s*[A-Za-z0-9_+\\-/]+){1,9}$","examples":["America/New_York,Europe/London,Asia/Seoul"],"description":"2–10 time zones, comma-separated; the first is the anchor whose local date is scanned"},"work_end":{"type":"string","default":"18:00","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","examples":["18:00"],"description":"Local end of working hours, HH:MM"},"work_start":{"type":"string","default":"09:00","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","examples":["09:00"],"description":"Local start of working hours, HH:MM"},"include_weekends":{"enum":["true","false"],"type":"string","default":"false","examples":["false"],"description":"Count Saturday/Sunday as working days"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["date","anchorZone","workHours","fullOverlap","overlapWindows","partialWindows","bestSlots","zones","notes"],"properties":{"date":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}},"zones":{"type":"array","items":{"type":"object","properties":{"zone":{"type":"string"},"utcOffset":{"type":"string"},"nextOffsetChange":{"type":["object","null"],"properties":{"at":{"type":"string"},"toOffsetMinutes":{"type":"integer"},"fromOffsetMinutes":{"type":"integer"}}}}}},"bestSlots":{"type":"array","items":{"type":"object","properties":{"local":{"type":"array","items":{"type":"object","properties":{"zone":{"type":"string"},"local":{"type":"string"},"weekday":{"type":"string"}}}},"startUtc":{"type":"string"},"durationMinutes":{"type":"integer"},"zonesInWorkHours":{"type":"array","items":{"type":"string"}}}}},"workHours":{"type":"object","properties":{"end":{"type":"string"},"start":{"type":"string"},"includeWeekends":{"type":"boolean"}}},"anchorZone":{"type":"string"},"fullOverlap":{"type":"boolean"},"overlapWindows":{"type":"array","items":{"type":"object","properties":{"local":{"type":"array","items":{"type":"object","properties":{"end":{"type":"string"},"zone":{"type":"string"},"start":{"type":"string"}}}},"endUtc":{"type":"string"},"minutes":{"type":"integer"},"startUtc":{"type":"string"},"zonesInWorkHours":{"type":"array","items":{"type":"string"}}}}},"partialWindows":{"type":"array","items":{"type":"object","properties":{"local":{"type":"array","items":{"type":"object","properties":{"end":{"type":"string"},"zone":{"type":"string"},"start":{"type":"string"}}}},"endUtc":{"type":"string"},"minutes":{"type":"integer"},"startUtc":{"type":"string"},"zonesInWorkHours":{"type":"array","items":{"type":"string"}}}}}}}}}}},"responseSchema":null,"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_0DurzN0ermCG9mLoqFZRP","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":"Computes shared working-hour overlap windows across 2–10 time zones for a given date, returning ranked meeting slots in UTC and local times with DST change alerts.","exampleAgentPrompt":"Find the best one-hour meeting slots for November 3rd 2026 that work across America/New_York, Europe/London, and Asia/Seoul, with standard 9am-6pm working hours — give me the top options ranked by how central they are in everyone's day.","exampleUseCases":[{"title":"Global product team standup scheduling","prompt":"We have team members in New York, London, and Seoul and want to schedule a standing weekly call on 2026-11-03 — can you find the overlap in our working hours (9am to 6pm) and give me the top three one-hour slots that are least disruptive for everyone?"},{"title":"Cross-continent investor call planning","prompt":"I need to set up a call between investors in America/Los_Angeles and America/New_York and a startup in Europe/Berlin on 2026-03-15 — what are the best overlapping windows during normal business hours, and are there any DST changes I should know about?"},{"title":"Weekend availability check for distributed team","prompt":"Our team spans America/Chicago, Asia/Tokyo, and Australia/Sydney — can you check if there's any working-hour overlap on 2026-07-20 if we include weekends, and list the partial windows if there's no full overlap?"}],"resultDescription":"A JSON object containing: the anchor date and zone, full and partial overlap windows expressed in UTC and every zone's local time, the top 3 ranked one-hour meeting slots (ranked by distance from each zone's day edges), and the next DST offset change for each zone, plus any explanatory notes.","failureModes":["Invalid or unrecognized time zone name returns an error","Fewer than 2 zones provided returns a validation error","Date format not matching YYYY-MM-DD returns a 400","No overlap at all between zones returns empty fullOverlap with partial windows only","More than 10 zones provided is rejected","work_start time >= work_end time may return empty results or error"],"whenToPreferThis":"Choose this endpoint when you need to find shared working-hour windows across 2–10 geographically distributed time zones for a specific date, especially when DST transitions are a concern. It is preferable over generic calendar APIs when you need ranked slot suggestions, partial overlap fallbacks, and per-zone DST alerts in a single call without authentication or signup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:00.128Z","isFirstParty":false,"canonicalSlug":"1gateway-time-zone-overlap-finder-76f47221"}