Search hotel availability and create a hotel (accommodation) booking using the Duffel Stays API.

Steps

1. Request Duffel Stays access (via duffel.com/contact-us) and create a test access token from the Duffel dashboard, since Stays isn't enabled by default the way Flights is.
2. Call POST /stays/search (duffel.stays.search) with rooms, a guests array (e.g. {type: "adult"}), check_in_date, check_out_date, and a location object (geographic_coordinates lat/long + radius in km) or specific accommodation IDs.
3. From the search response, pick the desired accommodation and note its search_result_id, then call POST /stays/search_results/{id}/actions/fetch_all_rates to retrieve every room and rate_id available for it.
4. Call POST /stays/quotes with the chosen rate_id to reconfirm the rate is still available and lock in a final price, receiving a quote_id back.
5. Call POST /stays/bookings with the quote_id, guest details (given_name, family_name, born_on), email, and phone_number to create the booking.
6. Handle the response: 201 returns the full booking immediately; 200/202 means the booking is still being confirmed with the supplier — listen for the stays.booking.created (or stays.booking_creation_failed) webhook rather than retrying the create-booking call.