Recent
Recommendations
Webhooks
Service
X (Twitter)
Service
YouTube
Service
Discord
Service
Google Sheets
Service
MyQ
Service
Gmail
Service
Instagram
Service
See all results
Explore
Plans
Log in
Get started
Mobile menu
Close menu
Back
Host Tools
Find bookings in a date range
This query returns the bookings on a listing between two dates.
Developer info
API endpoint slug
hosttools.find_bookings
Runtime method
performQuery("hosttools.find_bookings"}
Query fields
Listing
Dropdown list
Label
Listing
Helper text
The listing whose bookings you want.
Slug
listing
Required
true
Can have default value
false
From date
Text input > ISO 8601 date and time
Label
From date
Helper text
The first stay date to include, such as 2026-10-01 or today.
Slug
from_date
Required
true
Can have default value
true
To date
Text input > ISO 8601 date and time
Label
To date
Helper text
The last stay date to include, such as 2026-12-31 or in 3 months.
Slug
to_date
Required
true
Can have default value
true
Booking status
Dropdown list
Label
Booking status
Helper text
Limit the results to one booking status, or leave it on Any status.
Slug
booking_status
Required
false
Can have default value
true
Ingredients
Guest name
The guest's full name.
Slug
guest_name
Filter
Hosttools.findBookings.GuestName
Type
String
Example
Ada Testguest
Check in date
The check-in date, in the listing's local time zone.
Slug
check_in_date
Filter
Hosttools.findBookings.CheckInDate
Type
Date with time (ISO8601)
Example
2020-07-08T04:17:06+05:00
Check out date
The check-out date, in the listing's local time zone.
Slug
check_out_date
Filter
Hosttools.findBookings.CheckOutDate
Type
Date with time (ISO8601)
Example
2020-07-08T04:17:06+05:00
Nights
The number of nights in the stay.
Slug
nights
Filter
Hosttools.findBookings.Nights
Type
String
Example
3
Number of guests
The total number of guests on the booking.
Slug
number_of_guests
Filter
Hosttools.findBookings.NumberOfGuests
Type
String
Example
2
Status
The booking's status: accepted, pending, inquiry, or cancelled.
Slug
status
Filter
Hosttools.findBookings.Status
Type
String
Example
accepted
Booking channel
Where the booking came from, such as Airbnb, VRBO, Booking, Houfy, or internal.
Slug
booking_channel
Filter
Hosttools.findBookings.BookingChannel
Type
String
Example
Airbnb
Confirmation code
The booking's confirmation code, as shown to the guest.
Slug
confirmation_code
Filter
Hosttools.findBookings.ConfirmationCode
Type
String
Example
HT-AE523544
Guest price
The total price charged to the guest, in the listing's currency.
Slug
guest_price
Filter
Hosttools.findBookings.GuestPrice
Type
String
Example
450
Currency
The currency code for the booking's prices, such as USD.
Slug
currency
Filter
Hosttools.findBookings.Currency
Type
String
Example
USD
Booking
Host Tools' ID for the booking. Use it with the "Look up a booking" query and the "Send a message to a guest" action.
Slug
booking_id
Filter
Hosttools.findBookings.BookingId
Type
String
Example
6ab19e07cba21a8bc75f79e1
Applets using this Query
Add Host Tools bookings to Google Sheets
by
Host Tools
Email Host Tools bookings to Gmail
by
Host Tools
Send Host Tools bookings to Telegram on Button press
by
Host Tools
Append Host Tools bookings to Google Sheets when you enter an area
by
Host Tools
Post Host Tools bookings to Slack
by
Host Tools
Send booking summary to Notify! when Google Calendar event starts
by
Host Tools