Skip to main content
book_tour submits a tour request for a renter and slot returned by get_tour_availability.

​
Input

{
  "listing_id": "listing-record-id",
  "slot_id": "slot-id-from-availability",
  "renter": {
    "name": "Ada Lovelace",
    "email": "ada@example.com",
    "phone": "5555550100"
  },
  "notes": "Prefers mornings."
}
FieldTypeRequiredNotes
listing_idstringYesA listing snapshot id returned by search_listings.
slot_idstringYesA slot id returned by get_tour_availability.
renter.namestringYesRenter name.
renter.emailstringYesRenter email.
renter.phonestringNoRenter phone.
notesstringNoOptional note to include with the request.

​
Output

{
  "booking_id": "book_01HZY...",
  "status": "submitted",
  "next_step_message": "Confirmation email will follow.",
  "listing_id": "listing-record-id",
  "starts_at": "2026-07-02T10:00:00Z",
  "ends_at": "2026-07-02T10:30:00Z"
}

​
Limits and errors

If the slot is taken, expired, or otherwise unavailable, the tool returns SLOT_NOT_AVAILABLE. BrightPlace also limits active tour requests to 2 per renter email in a rolling 24-hour window. Additional active requests return BOOKING_LIMIT_REACHED. Because book_tour submits renter contact information, clients should ask users to review the request before calling the tool.