Prepare a booking for the guest
prepare_bookingKeeps a stay (check_in and check_out) or a time slot (date, start_time, end_time) at one listing, with the name and contacts of the person booking, and returns a link to a Roraima page where that person checks the booking and pays, with these details already filled in. Availability and price are checked as in get_quote. The link carries only a random code, works once and expires after two hours; the details are then deleted. This answer does not repeat the name or the contacts. The booking exists only once it is paid on the page.
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": {
"listing_id": "<listing_id>",
"guests": "<guests>",
"first_name": "<first_name>",
"last_name": "<last_name>",
"email": "<email>"
},
"name": "prepare_booking"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Day of the time slot, YYYY-MM-DD (listings booked by time slots). | |
| Yes | Email of the person booking. | ||
| phone | No | Phone of the person booking, with the international prefix (for example +39...). Used only where the checkout of the listing asks for a phone number. | |
| guests | Yes | Number of guests. | |
| check_in | No | Arrival date, YYYY-MM-DD (listings booked by nights). | |
| end_time | No | Slot end, HH:MM. | |
| language | No | Language of names, descriptions and page links. Default en. | |
| check_out | No | Departure date, YYYY-MM-DD. | |
| last_name | Yes | Last name of the person booking. | |
| first_name | Yes | First name of the person booking. | |
| listing_id | Yes | listing_id from search_listings. | |
| start_time | No | Slot start, HH:MM. |