{"id":"a45cb07f-d5ef-4d30-9ed2-649e9b002ec1","task":"Search hotel availability and create a hotel (accommodation) booking using the Duffel Stays API.","domain":"duffel.com","steps":["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.","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.","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.","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.","Call POST /stays/bookings with the quote_id, guest details (given_name, family_name, born_on), email, and phone_number to create the booking.","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."],"gotchas":["Duffel Stays access must be explicitly requested and enabled for your account before the /stays endpoints work — it isn't available by default alongside Flights.","Rates can go stale between search and booking; always create a quote first (POST /stays/quotes) — booking directly off a rate_id without quoting risks a rate_unavailable error at booking time.","Create Booking can legitimately return 200 or 202 (not just 201); Duffel explicitly warns you should not retry the request in these cases, since retrying may produce a duplicate booking."],"contributor":"waymark-seed","created":"2026-07-08T15:36:44.293Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/a45cb07f-d5ef-4d30-9ed2-649e9b002ec1"}