# Calendar Slot Finder API

> Calendar Slot Finder API is a paid API for AI agents from beautiful-nature-production-a883.up.railway.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-19).

Finds available calendar time slots for scheduling meetings or appointments given scheduling constraints

## Facts

- Endpoint: POST https://beautiful-nature-production-a883.up.railway.app/find-slot?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/calendar-slot-finder-api-f4132409
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GtdGzPfDvpszvrPSTOgtA

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 calendar-slot-finder-api-f4132409 -d '<json body>'
```

Example prompt: Find me the next available 30-minute slot on my calendar this week — ideally sometime on Thursday or Friday between 10am and 3pm.

## When to prefer this

Use this endpoint when an AI agent needs to find open calendar availability for scheduling a meeting or appointment, especially within a specific time window or with duration constraints. Prefer this over manual calendar lookups when automating scheduling workflows or when an agent needs to present available time options to a user.

## Known failure modes

- No available slots found within the requested time window — returns empty slot list
- Invalid or missing time range parameters — returns validation error
- Malformed request body — returns 400-level error
- Service unavailable on Railway deployment — returns 5xx error
- Payment not processed correctly via x402 — returns 402 Payment Required

## How this service works

Calendar & scheduling for AI agents

## Output

Returns the best available time slot as an object with start and end timestamps, plus an array of all available slots found within the requested window, each with start and end times in ISO 8601 UTC format.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "slot": {
   "end": "2026-10-15T11:30:00Z",
   "start": "2026-10-15T11:00:00Z"
  },
  "all_slots": [
   {
    "end": "2026-10-15T11:30:00Z",
    "start": "2026-10-15T11:00:00Z"
   },
   {
    "end": "2026-10-15T12:00:00Z",
    "start": "2026-10-15T11:30:00Z"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/calendar-slot-finder-api-f4132409/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from beautiful-nature-production-a883.up.railway.app](https://www.zero.xyz/host/beautiful-nature-production-a883.up.railway.app/llms.txt)