Check availability and price
check_availabilityChecks whether a listing can be booked for given dates, at which rate and for how much — the same answer the listing page gives a visitor. Returns { available, reason, recommendedRate, options, bookedRanges, bookingUrl }. Each option states whether that rate is eligible (and why not), the rate per period, the first payment and the full payment schedule. Livuma charges guests no service fee, so the amounts are what the guest pays. bookingUrl opens the listing on livuma.com with these dates selected; the booking itself (card authorisation, 3-D Secure, identity verification) is completed there by the guest.
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": {
"listingId": "<listingId>",
"checkInDate": "<checkInDate>"
},
"name": "check_availability"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| listingId | Yes | The listing's "id" from search results (GUID), a short /s/{id} id, or the listing URL. | |
| rentalMode | No | "dates" (default), "open_ended" (no end date, monthly) or "yearly" (fixed 12-month term). | |
| checkInDate | Yes | Check-in date, yyyy-MM-dd. Required. | |
| checkOutDate | No | Check-out date, yyyy-MM-dd. Omit for open_ended and yearly. |