# Date Math Free Slots Finder

> Date Math Free Slots Finder is a paid API for AI agents from date-math.datemath.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-21).

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.

## Facts

- Endpoint: POST https://date-math.datemath.workers.dev/v1/free_slots?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/date-math-free-slots-finder-1b3ed3db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0czVEc3EW8Y7cIskPlWFf

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 date-math-free-slots-finder-1b3ed3db -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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": 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/date-math-free-slots-finder-1b3ed3db/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from date-math.datemath.workers.dev](https://www.zero.xyz/host/date-math.datemath.workers.dev/llms.txt)
