Back to Tools

query_availability

read:services, read:bookings

List available time slots for a service on a specific date.

Input Parameters

Parameters

PropertyTypeDescription
service_idrequiredstringService UUID
daterequiredstringDate to query (YYYY-MM-DD)
duration_minutesnumberOverride duration in minutes (15-480)
team_member_idstringFilter to a specific team member UUID
timezonestringIANA timezone (defaults to business timezone)

Response

Response Schema

PropertyTypeDescription
daterequiredstringDate queried (YYYY-MM-DD)
timezonerequiredstringTimezone used for slot generation
slot_countrequirednumberNumber of slots returned
slotsrequiredAvailabilitySlot[]Slot windows ({start_time, end_time, available, team_member_ids, reason})

Example

Requestjson
{
  "type": "tool",
  "name": "query_availability",
  "params": {
    "service_id": "service-uuid",
    "date": "2026-01-15",
    "timezone": "America/Los_Angeles"
  }
}
Responsejson
{
  "success": true,
  "data": {
    "date": "2026-01-15",
    "timezone": "America/Los_Angeles",
    "slot_count": 1,
    "slots": [
      {
        "start_time": "2026-01-15T18:00:00Z",
        "end_time": "2026-01-15T19:00:00Z",
        "available": true,
        "team_member_ids": ["uuid"],
        "reason": null
      }
    ]
  }
}

cURL Example

curl -X POST https://app.bizily.io/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{\n  "type": "tool",\n  "name": "query_availability",\n  "params": {\n    "service_id": "service-uuid",\n    "date": "2026-01-15",\n    "timezone": "America/Los_Angeles"\n  }\n}'