{"uid":"cap_ygc0LYuAevbicgyymJgjW","slug":"meeting-slot-finder-cross-timezone-overlap-d19daf82","name":"Meeting Slot Finder – Cross-Timezone Overlap","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. Free tier returns at most 1 slot; the paid endpoint returns every matching slot (see 'upgrade' in the response).","url":"https://api.agishub.com/v1/meeting-slots","method":"GET","headers":{},"bodySchema":{"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 }, country? (ISO alpha-2) }."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"enum":["json"],"type":"string"},"example":{"type":"object"}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"result":"Find working-hour time slots that overlap across participants in different timezones for a meeting of a given duration, "}},"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_3ul9hIHqOHfBC4JMHKgnc","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 working-hour time slots that overlap across participants in different timezones for a meeting of a given duration, excluding weekends and public holidays.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Global team standup scheduling","prompt":"Find a 30-minute slot next week (July 21–25) for a daily standup with my team — one person in San Francisco (America/Los_Angeles, US), one in London (Europe/London, GB), and one in Singapore (Asia/Singapore, SG), all with standard 9am–6pm working hours."},{"title":"Cross-country client call avoiding holidays","prompt":"I need to set up a 60-minute call with a client in Paris (Europe/Paris, FR) and a colleague in Mexico City (America/Mexico_City, MX) sometime between August 4 and August 8 — can you find slots that avoid any local public holidays?"},{"title":"Recruitment interview slot finder","prompt":"Help me find a 45-minute interview window between August 11 and August 15 for a candidate in Sydney (Australia/Sydney, AU) working 9am–5pm and an interviewer in New York (America/New_York, US) working 10am–6pm, avoiding public holidays in both countries."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:39:54.709Z","isFirstParty":false}