Open times
check_availabilityUse this when the person has chosen a service and wants to know when it can be done. Returns open times over up to 14 days, each on the business's clock and, when you pass clientTimeZone, on the person's clock too, with the price at that time. A time marked bookVia assistant has a slotId to pass to hold_booking within 30 minutes. Quote times from the display fields as given. A service whose bookVia is enquiry has no times here. Do not use for holding or booking a time: only hold_booking holds one.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"business": "<business>",
"serviceId": "<serviceId>",
"dateFrom": "<dateFrom>"
},
"name": "check_availability"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | 1 to 40, 12 when not given. | |
| dateTo | No | YYYY-MM-DD, at most 14 days in all. | |
| staffId | No | A person, when the client wants one. | |
| addOnIds | No | ||
| business | Yes | The business: its bookatu.com link or its own domain on Bookatu, or its slug. | |
| dateFrom | Yes | YYYY-MM-DD. | |
| language | No | The language to answer in (BCP 47). | |
| dateClock | No | Whose calendar the dates are on (the business's when not given). | |
| partOfDay | No | ||
| partySize | No | ||
| serviceId | Yes | ||
| locationId | No | A branch of the business. | |
| clientTimeZone | No | The client's IANA time zone, such as America/Toronto. Ask for their city when unsure. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | Yes | ||
| meta | Yes | ||
| more | Yes | ||
| notes | Yes | ||
| slots | Yes | ||
| client | Yes | ||
| window | Yes | ||
| bookVia | Yes | assistant: a time can be held here. website: the client books on the business's booking page. enquiry: the person asks the business with send_enquiry. | |
| service | Yes | ||
| business | Yes | ||
| warnings | Yes | ||
| bookingPageUrl | No | Where the client books a time marked website. | |
| freeCancellationRule | Yes |