# Meeting Slot Finder – Cross-Timezone Overlap

> Meeting Slot Finder – Cross-Timezone Overlap is a paid API for AI agents from api.agishub.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Finds working-hour time slots that overlap across participants in different timezones for a meeting of a given duration, excluding weekends and public holidays.

## Facts

- Endpoint: GET https://api.agishub.com/v1/meeting-slots
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meeting-slot-finder-cross-timezone-overlap-d19daf82
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ygc0LYuAevbicgyymJgjW

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 meeting-slot-finder-cross-timezone-overlap-d19daf82
```

Example prompt: Can you find a 45-minute meeting slot this week (July 14–18) that works for three people: one in New York (America/New_York, US), one in London (Europe/London, GB), and one in Berlin (Europe/Berlin, DE), all working 9am–5pm local time?

## When to prefer this

Use this endpoint when you need to programmatically find meeting times across participants in different timezones, especially when public holiday exclusion per country is required. It is purpose-built for cross-timezone scheduling logic, handling IANA timezone conversions, working-hour windowing, and holiday calendars internally — saving the agent from implementing complex calendar math. Prefer this over a general-purpose LLM or date-arithmetic endpoint when correctness of timezone overlap computation matters, or when participant count and date range make manual reasoning error-prone.

## Known failure modes

- No overlapping slots exist — returns empty list when participants' working hours don't overlap at all
- Invalid IANA timezone string — returns error for unrecognized timezone identifiers
- Invalid ISO 3166-1 alpha-2 country code — returns error or ignores holiday filtering
- Date range too narrow or participants span too many timezones with non-overlapping hours — empty result
- Free tier truncation — returns only 1 slot even when multiple exist; 'upgrade' field hints at paid access
- Malformed date_range (wrong format) — returns validation error
- Duration longer than any possible overlap window — returns empty list

## How this service works

Find working-hour time slots that overlap across participants in different timezones for a meeting of a given duration, excluding weekends and (when a country is given per participant) that person's public holidays. Free tier returns at most 1 slot; the paid endpoint returns every matching slot (see 'upgrade' in the response).

## Output

Returns a list of time slot objects representing periods where all participants' working hours overlap within the given date range, with each slot expressed in a common format. The free tier returns at most one slot; the paid endpoint returns all matching slots. If no slots are found, an empty list is returned. The response may include an 'upgrade' field pointing to the paid endpoint when results are truncated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "enum": [
      "http"
     ],
     "type": "string"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "participants",
      "duration",
      "date_range"
     ],
     "properties": {
      "duration": {
       "type": "number",
       "description": "Meeting duration in minutes."
      },
      "date_range": {
       "type": "object",
       "required": [
        "start",
        "end"
       ],
       "properties": {
        "end": {
         "type": "string",
         "description": "Last date to search \"YYYY-MM-DD\"."
        },
        "start": {
         "type": "string",
         "description": "First date to search \"YYYY-MM-DD\"."
        }
       },
       "description": "Inclusive date window to search, e.g. { \"start\":\"2026-07-13\", \"end\":\"2026-07-17\" }.",
       "additionalProperties": false
      },
      "participants": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "timezone"
        ],
        "properties": {
         "country": {
          "type": "string",
          "description": "ISO 3166-1 alpha-2 code (e.g. 'US', 'ES') to exclude that person's public holidays."
         },
         "timezone": {
          "type": "string",
          "description": "Participant's IANA timezone, e.g. 'Europe/Madrid'."
         },
         "working_hours": {
          "type": "object",
          "required": [
           "start",
           "end"
          ],
          "properties": {
           "end": {
            "type": "string",
            "description": "Local end time \"HH:mm\" (24h), e.g. \"17:00\"."
           },
           "start": {
            "type": "string",
            "description": "Local start time \"HH:mm\" (24h), e.g. \"09:00\"."
           }
          },
          "description": "This participant's local working hours. Defaults to 09:00-17:00.",
          "additionalProperties": false
         }
        },
        "additionalProperties": false
       },
       "minItems": 1,
       "description": "The people to meet. Each participant is { timezone (IANA, required), working_hours? { start, end }
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": "Find working-hour time slots that overlap across participants in different timezones for a meeting of a given duration, "
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meeting-slot-finder-cross-timezone-overlap-d19daf82/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agishub.com](https://www.zero.xyz/host/api.agishub.com/llms.txt)