{"uid":"cap_Zg_Cr2RaF1qvo4sTOfKsU","slug":"agishub-meeting-slot-finder-dd81fd6a","name":"AGISHub Meeting Slot Finder","description":"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.","url":"https://api.agishub.com/paid/meeting-slots","method":"POST","headers":{},"bodySchema":{"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"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"enum":["json"],"type":"string"},"example":{"type":"object"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_izX7rmyPjxNxbP1V4Mej-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds overlapping working-hour time slots across participants in different timezones for a meeting, excluding weekends and public holidays.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Global engineering standup scheduling","prompt":"Find a 30-minute slot next week (2026-07-13 to 2026-07-17) where my engineering team can all meet — one person is in Europe/Berlin (Germany, 09:00-17:00), one in America/Chicago (US, 09:00-17:00), and one in Asia/Singapore (08:00-18:00). Skip weekends and their public holidays."},{"title":"Executive cross-continent 1:1","prompt":"When can my CEO in America/Los_Angeles and our partner in Asia/Tokyo have a 60-minute call sometime between 2026-07-20 and 2026-07-24? Both work standard 9-to-5 hours local time, and please skip Japanese holidays."},{"title":"Client kickoff across three continents","prompt":"I need a 90-minute kickoff slot between July 13 and July 17 for three clients: one in Europe/Madrid (Spain, 09:00-18:00), one in America/Sao_Paulo (Brazil, 08:00-17:00), and one in Australia/Sydney (Australia, 09:00-17:00). Find a window that works for all of them, excluding weekends and their respective public holidays."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:49:43.832Z","isFirstParty":false}