Explore Plans
Mobile menu Close menu
Host Tools

Look up a booking

Pro plus icon This query returns the full details of one booking.

Developer info

API endpoint slug
hosttools.look_up_booking
Runtime method
performQuery("hosttools.look_up_booking"}

Query fields

Booking Text input > Other

Label
Booking ID
Helper text
The Booking ID from a Host Tools trigger. This is not the guest-facing confirmation code.
Slug
booking_id
Required
true
Can have default value
true

Ingredients

Guest name The guest's full name.

Slug
guest_name
Filter code
Hosttools.lookUpBooking.GuestName
Type
String
Example
Ada Testguest

Guest email The guest's email address.

Slug
guest_email
Filter code
Hosttools.lookUpBooking.GuestEmail
Type
String
Example
guest@example.com

Guest phone The guest's phone number.

Slug
guest_phone
Filter code
Hosttools.lookUpBooking.GuestPhone
Type
String
Example
+14155550123

Check in date The check-in date, in the listing's local time zone.

Slug
check_in_date
Filter code
Hosttools.lookUpBooking.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 code
Hosttools.lookUpBooking.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 code
Hosttools.lookUpBooking.Nights
Type
String
Example
3

Number of guests The total number of guests on the booking.

Slug
number_of_guests
Filter code
Hosttools.lookUpBooking.NumberOfGuests
Type
String
Example
2

Status The booking's status: accepted, pending, inquiry, or cancelled.

Slug
status
Filter code
Hosttools.lookUpBooking.Status
Type
String
Example
accepted

Booking channel Where the booking came from, such as Airbnb, VRBO, Booking, Houfy, or internal.

Slug
booking_channel
Filter code
Hosttools.lookUpBooking.BookingChannel
Type
String
Example
Airbnb

Confirmation code The booking's confirmation code, as shown to the guest.

Slug
confirmation_code
Filter code
Hosttools.lookUpBooking.ConfirmationCode
Type
String
Example
HT-AE523544

Guest price The total price charged to the guest, in the listing's currency.

Slug
guest_price
Filter code
Hosttools.lookUpBooking.GuestPrice
Type
String
Example
450

Host payout The amount paid out to you for the booking, in the listing's currency.

Slug
host_payout
Filter code
Hosttools.lookUpBooking.HostPayout
Type
String
Example
405

Currency The currency code for the booking's prices, such as USD.

Slug
currency
Filter code
Hosttools.lookUpBooking.Currency
Type
String
Example
USD

Notes Your private notes on the booking.

Slug
notes
Filter code
Hosttools.lookUpBooking.Notes
Type
String
Example
Late arrival, lockbox code sent.

Total fees The total fees on the booking, in the listing's currency. Blank when the booking has no fee line items.

Slug
total_fees
Filter code
Hosttools.lookUpBooking.TotalFees
Type
String
Example
75

Total taxes The total taxes on the booking, in the listing's currency. Blank when the booking has no tax line items.

Slug
total_taxes
Filter code
Hosttools.lookUpBooking.TotalTaxes
Type
String
Example
36