# AGISHub Meeting Slot Finder

> AGISHub Meeting Slot Finder 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-14).

Finds overlapping working-hour time slots across participants in different timezones for a meeting, excluding weekends and public holidays.

## Facts

- Endpoint: POST https://api.agishub.com/paid/meeting-slots
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agishub-meeting-slot-finder-dd81fd6a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Zg_Cr2RaF1qvo4sTOfKsU

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 agishub-meeting-slot-finder-dd81fd6a -d '<json body>'
```

Example prompt: Find all 45-minute meeting slots this coming Monday through Friday (2026-07-13 to 2026-07-17) where Alice in Europe/London (UK) and Bob in America/New_York (US) are both in their standard 9am-5pm working hours — exclude weekends and public holidays.

## When to prefer this

Use this endpoint when you need to find overlapping working-hour windows for two or more participants spread across different timezones, especially when you also need to respect country-specific public holidays. It is preferable over generic calendar APIs when you do not have access to participants' calendar systems and only know their timezones and working hours. Ideal for scheduling assistants, meeting bots, or workflow automations that need to propose concrete meeting times without requiring OAuth calendar access.

## Known failure modes

- No overlapping slots found within the date range (empty slots array returned)
- Invalid IANA timezone string causes a 400/422 error
- Invalid ISO 3166-1 alpha-2 country code causes a 400/422 error
- Invalid date_range format or end before start causes a validation error
- Duration too long to fit in any shared working window results in empty slots
- Payment not provided or insufficient (402 Payment Required for paid tier)
- Date range too wide may result in slow response or timeout

## 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.

## Output

Returns a list of available time slots (start/end timestamps) when all participants' working hours overlap within the given date range, respecting each participant's timezone, custom working hours, weekends exclusion, and country-specific public holidays. The free tier returns at most 1 slot; the paid endpoint returns all matching slots. The response also includes an 'upgrade' field describing how to access additional results.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "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 }, country? (ISO alpha-2) }."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "enum": [
      "http"
     ],
     "type": "string
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agishub-meeting-slot-finder-dd81fd6a/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)