# 1gateway Time Zone Overlap Finder

> 1gateway Time Zone Overlap Finder is a paid API for AI agents from 1gateway.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-31).

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.

## Facts

- Endpoint: GET https://1gateway.dev/v1/time/overlap?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/1gateway-time-zone-overlap-finder-76f47221
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OgrztEQorlsPjFypg99jY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 1gateway-time-zone-overlap-finder-76f47221
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/1gateway-time-zone-overlap-finder-76f47221/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 1gateway.dev](https://www.zero.xyz/host/1gateway.dev/llms.txt)