Back to Tools
query_availability
read:services, read:bookingsList available time slots for a service on a specific date.
Input Parameters
Parameters
| Property | Type | Description |
|---|---|---|
service_idrequired | string | Service UUID |
daterequired | string | Date to query (YYYY-MM-DD) |
duration_minutes | number | Override duration in minutes (15-480) |
team_member_id | string | Filter to a specific team member UUID |
timezone | string | IANA timezone (defaults to business timezone) |
Response
Response Schema
| Property | Type | Description |
|---|---|---|
daterequired | string | Date queried (YYYY-MM-DD) |
timezonerequired | string | Timezone used for slot generation |
slot_countrequired | number | Number of slots returned |
slotsrequired | AvailabilitySlot[] | 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}'