{"uid":"cap_0czVEc3EW8Y7cIskPlWFf","slug":"date-math-free-slots-finder-1b3ed3db","name":"Date Math Free Slots Finder","description":"Date Math: Find meeting times when everyone is free: intersects each participant's working hours (own time zone, workdays, country holidays) minus their busy blocks, then lists slots of the requested length. Up to 10 people, 14 days, optional buffer between meetings. Use for scheduling across calendars and time zones.","url":"https://date-math.datemath.workers.dev/v1/free_slots?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"days":{"type":"integer","default":5,"maximum":14,"minimum":1},"from":{"type":"string","example":"2026-11-07","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"timezone":{"type":"string","example":"Asia/Manila","description":"Organizer's zone: defines the days searched and slot alignment (default: first participant's)"},"work_end":{"type":"string","pattern":"^([01]\\d|2[0-4]):[0-5]\\d$","description":"Default end of working hours, 17:00"},"max_slots":{"type":"integer","default":10,"maximum":50,"minimum":1},"not_before":{"type":"string","description":"Earliest slot start: ISO 8601 with offset, or \"now\""},"work_start":{"type":"string","pattern":"^([01]\\d|2[0-4]):[0-5]\\d$","description":"Default start of working hours, 09:00"},"participants":{"type":"array","items":{"type":"object","required":["timezone"],"properties":{"busy":{"type":"array","items":{"type":"object","required":["start","end"],"properties":{"end":{"type":"string","description":"ISO 8601 with offset"},"start":{"type":"string","description":"ISO 8601 with offset"}}},"maxItems":200,"description":"Busy blocks, up to 100 per person (300 total)"},"country":{"type":"string","example":"US","pattern":"^[A-Za-z]{2}$","description":"ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days"},"holidays":{"type":"array","items":{"type":"string","example":"2026-11-07","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"maxItems":1000,"description":"Extra dates excluded from business-day counts (rest days from workdays are always excluded)"},"timezone":{"type":"string","example":"Asia/Manila","description":"IANA time zone, e.g. Asia/Manila"},"work_end":{"type":"string","pattern":"^([01]\\d|2[0-4]):[0-5]\\d$","description":"Overrides the default work_end"},"workdays":{"type":"array","items":{"type":"integer","maximum":6,"minimum":0},"example":[1,2,3,4,5],"maxItems":7,"minItems":1,"description":"Working days of the week, 0 = Sunday. Default [1,2,3,4,5] (Mon–Fri); e.g. [0,1,2,3,4] for Sun–Thu or [1,2,3,4,5,6] for Mon–Sat"},"work_start":{"type":"string","pattern":"^([01]\\d|2[0-4]):[0-5]\\d$","description":"Overrides the default work_start"}}},"maxItems":10,"minItems":1},"step_minutes":{"type":"integer","default":30,"maximum":60,"minimum":5,"description":"Slot start alignment"},"buffer_minutes":{"type":"integer","default":0,"maximum":120,"minimum":0,"description":"Free time kept around busy blocks"},"duration_minutes":{"type":"integer","maximum":720,"minimum":5}}},"responseSchema":{"type":"json","example":{"count":3,"range":{"end":"2026-11-12T00:00:00+08:00","start":"2026-11-10T00:00:00+08:00"},"slots":[{"local":[{"end":"2026-11-10T16:30:00+08:00","start":"2026-11-10T16:00:00+08:00","timezone":"Asia/Manila"}],"end_utc":"2026-11-10T08:30:00Z","start_utc":"2026-11-10T08:00:00Z"}],"timezone":"Asia/Manila","free_windows":[{"end":"2026-11-10T17:00:00+08:00","start":"2026-11-10T16:00:00+08:00","end_utc":"2026-11-10T09:00:00Z","minutes":60,"start_utc":"2026-11-10T08:00:00Z"}],"duration_minutes":30}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oMchOZQPaV56loIdRt1z2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds available meeting time slots by intersecting participants' working hours, time zones, country holidays, and busy blocks to list open windows of a requested duration.","exampleAgentPrompt":"Find me 3 available 30-minute meeting slots starting from November 10, 2026, for the next 5 days, for two participants — one in Asia/Manila (busy 2026-11-10T01:00:00Z to 2026-11-10T03:00:00Z) and one in America/New_York — both working 9am–5pm Monday through Friday, with a 10-minute buffer between meetings.","exampleUseCases":[{"title":"Global team weekly sync scheduling","prompt":"I need to find a 60-minute slot this week for a team meeting across 4 people: one in London, one in New York, one in Tokyo, and one in Manila — all working standard 9-to-5 hours Monday through Friday. Can you find the top 5 available windows starting today?"},{"title":"Cross-timezone client call with holiday avoidance","prompt":"Help me schedule a 45-minute call with a US client (country code US) and a UK client (country code GB) sometime in the next 7 days starting November 10, 2026 — make sure it avoids their public holidays and their existing busy blocks: US is busy Nov 11 9–10am UTC, UK is busy Nov 12 2–3pm UTC."},{"title":"Executive one-on-one with buffer time","prompt":"Find 30-minute slots for a one-on-one between two executives over the next 3 days from 2026-11-10 — one is in America/Chicago working 8am–6pm, the other is in Europe/Berlin working 9am–5pm — and add a 15-minute buffer between any meetings."}],"resultDescription":"Returns a list of free time slots with UTC start/end times and localized times per participant, plus a count of slots found, the searched date range, free windows showing available blocks, and the meeting duration in minutes.","failureModes":["No free slots found if participants have incompatible working hours or fully booked calendars","Invalid timezone string returns an error","Busy block timestamps missing UTC offset cause parsing failures","Requesting more than 10 participants or 14 days returns a validation error","Malformed date format for 'from' field causes a 400 error","Overlapping or invalid busy block ranges may produce unexpected results"],"whenToPreferThis":"Use this endpoint when you need to find meeting times that work for multiple people across different time zones, working schedules, and national holidays simultaneously. It is the right choice when you have busy calendar data per person and need intersection logic rather than just converting times. Prefer this over manual timezone conversion tools when coordinating across countries or when holiday-awareness is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-21T12:36:54.858Z","isFirstParty":false,"canonicalSlug":"date-math-free-slots-finder-1b3ed3db"}