Send Authorization: Bearer YOUR_CONNECTOR_TOKEN with each operation request. No Airbnb account token or provider connection is required.
The operator must enable the GB guest runtime and configure its private routing key. Callers never supply that key. An unavailable or challenged provider fails the request without login fallback.
Use the returned listing_id and selected_stay dates to load a search result. For flexible results with no selected dates, choose dates before loading the listing. Currency defaults to GBP; choose any of the 47 supported guest display codes in the input schema. Set currency on predictions and stay.currency on search, listing and available-stay requests. Price filters use the selected currency’s displayed units. Prices are provider display strings, not minor-unit amounts; ajar does not convert exchange rates. Keep the same currency when loading a result or paginating; changing it invalidates existing cursors.
Available-stay discovery treats stay.checkin and stay.checkout as the date window and nights as the stay length. Read exhausted before treating an empty result as a complete scan; at most 20 candidates are confirmed. Quotes can change before booking.
Authentication guide