Calendars, booking & time
Manage schedules, appointments, and time operations. Check availability, book time slots, sync calendars, and perform date calculations.
Check schedule availability for any date range. Returns available time slots and conflicts.
POST /api/v1/scheduling/availability
{ "calendar_id": "cal_123",
"date": "2024-01-20",
"duration": 30 }
// Response
{ "available": true,
"slots": [
{ "start": "09:00", "end": "09:30" },
{ "start": "10:00", "end": "10:30" },
{ "start": "14:00", "end": "14:30" }
] }
Book time slots with automatic conflict detection. Supports recurring appointments.
POST /api/v1/scheduling/book
{ "calendar_id": "cal_123",
"start": "2024-01-20T09:00:00",
"end": "2024-01-20T09:30:00",
"title": "Team Meeting" }
// Response
{ "booking_id": "bk_789",
"status": "confirmed",
"calendar_link": "https://..." }
Sync calendars across platforms. Google Calendar, Outlook, and iCal support.
POST /api/v1/scheduling/sync
{ "source": "google",
"target": "outlook",
"calendar_id": "cal_123" }
// Response
{ "sync_id": "sync_456",
"status": "active",
"last_sync": "2024-01-19T15:30:00",
"events_synced": 42 }
Get operating hours for businesses. Supports holidays and special hours.
GET /api/v1/scheduling/hours/biz_123
// Response
{ "business_id": "biz_123",
"timezone": "America/New_York",
"hours": {
"monday": { "open": "09:00", "close": "17:00" },
"tuesday": { "open": "09:00", "close": "17:00" },
"saturday": "closed" },
"is_open_now": true }
Convert times between time zones. Handles DST transitions automatically.
GET /api/v1/scheduling/convert
?time=2024-01-20T09:00:00
&from=America/New_York
&to=Europe/London
// Response
{ "original": "2024-01-20T09:00:00-05:00",
"converted": "2024-01-20T14:00:00+00:00",
"offset_diff": "+5 hours",
"dst_note": "No DST transition" }
Perform date and time arithmetic. Add/subtract durations, calculate differences.
POST /api/v1/scheduling/calculate
{ "date": "2024-01-20",
"operation": "add",
"value": 30,
"unit": "business_days" }
// Response
{ "original": "2024-01-20",
"result": "2024-03-01",
"calendar_days": 41,
"business_days": 30,
"weekends_skipped": 8 }
Get your API key and start managing schedules in minutes.