Search Result
A search result is a pending availability for an accommodation on a given check in and check out dates.
Schema
The cheapest_rate_base_amount
is for search result display purposes. It is equivalent to the cheapest rate base_amount for the cheapest room at this accommodation.
The rate amount is a best effort computation during the time a search is made, and can change when fetching the rates. It is not guaranteed to be accurate.
This can be null
if the base amount is unknown.
"699.00"
The currency for cheapest_rate_base_amount
for this accommodation, as an ISO 4217 currency code.
"GBP"
The currency for cheapest_rate_total_amount
for this accommodation, as an ISO 4217 currency code.
"GBP"
The cheapest_rate_due_at_accommodation_amount
is for search result display purposes. It is equivalent to the cheapest rate due_at_accommodation_amount for the cheapest room at this accommodation.
The rate amount is a best effort computation during the time a search is made, and can change when fetching the rates. It is not guaranteed to be accurate.
This can be null
if the due at the accommodation amount is unknown.
"699.00"
The currency for cheapest_rate_due_at_accommodation_amount
for this accommodation, as an ISO 4217 currency code.
"GBP"
The cheapest_rate_public_amount
is for search result display purposes. It is equivalent to the cheapest rate public_amount for the cheapest room at this accommodation.
The rate amount is a best effort computation during the time a search is made, and can change when fetching the rates. It is not guaranteed to be accurate.
The amount will usually be higher than the cheapest_rate_total_amount
, but can be lower. This can be null
if the public amount is unknown.
"899.00"
The currency for cheapest_rate_public_amount
for this accommodation, as an ISO 4217 currency code.
"GBP"
The cheapest_rate_total_amount
is for search result display purposes. It is equivalent to the cheapest rate total_amount for the cheapest room at this accommodation.
The rate amount is a best effort computation during the time a search is made, and can change when fetching the rates. It is not guaranteed to be accurate. It will always show a value, even when rooms data is empty in the initial Search response.
"799.00"
Endpoint
POST https://api.duffel.com/stays/search_results/{search_result_id}/actions/fetch_all_rates
Request
curl -X POST --compressed "https://api.duffel.com/stays/search_results/{search_result_id}/actions/fetch_all_rates" \-H "Accept-Encoding: gzip" \-H "Accept: application/json" \-H "Content-Type: application/json" \-H "Duffel-Version: v2" \-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"
Response
{"data": {"supported_negotiated_rates": [{"id": "nre_0000AvtkNoC81yBytDM9PE","display_name": "2025 Negotiated Rate"}],"rooms": 1,"id": "srr_0000ASVBuJVLdmqtZDJ4ca","guests": [{"type": "adult","age": 7}],"check_out_date": "2023-05-28","check_in_date": "2023-05-24","cheapest_rate_total_amount": "799.00","cheapest_rate_public_currency": "GBP","cheapest_rate_public_amount": "899.00","cheapest_rate_due_at_accommodation_currency": "GBP","cheapest_rate_due_at_accommodation_amount": "699.00","cheapest_rate_currency": "GBP","cheapest_rate_base_currency": "GBP","cheapest_rate_base_amount": "699.00","accommodation": {"supported_loyalty_programme": "duffel_hotel_group_rewards","rooms": [{"rates": [{"total_currency": "GBP","total_amount": "799.00","tax_currency": "GBP","tax_amount": "82.23","supported_loyalty_programme": "duffel_hotel_group_rewards","quantity_available": 12,"public_currency": "GBP","public_amount": "699.99","payment_type": "pay_now","negotiated_rate_id": "nre_0000ATOwpuYnZohiSmlmyz","loyalty_programme_required": false,"id": "rat_0000BTVRuKZTavzrZDJ4cb","fee_currency": "GBP","fee_amount": "50.94","due_at_accommodation_currency": "GBP","due_at_accommodation_amount": "39.95","deal_types": ["closed_user_group","mobile"],"conditions": [{"title": "Parking","description": "Public parking is available nearby for £15 per day"}],"code": "ABC","cancellation_timeline": [{"refund_amount": "799.00","currency": "GBP","before": "2023-05-23T13:00:00Z"}],"board_type": "room_only","base_currency": "GBP","base_amount": "665.83","available_payment_methods": [["balance"]]}],"photos": [{"url": "https://assets.duffel.com/img/stays/image.jpg"}],"name": "Double Suite","beds": [{"type": "king","count": 2}]}],"review_score": 8.8,"review_count": 336,"rating": 3,"photos": [{"url": "https://assets.duffel.com/img/stays/image.jpg"}],"phone_number": "+442074938181","payment_instruction_supported": false,"name": "Duffel Test Hotel","location": {"geographic_coordinates": {"longitude": -0.1416,"latitude": 51.5071},"address": {"region": "England","postal_code": "EC2A 4TP","line_one": "100 Clifton Street","country_code": "GB","city_name": "London"}},"key_collection": {"instructions": "Please collect the keys from accommodation's reception."},"id": "acc_0000AWr2VsUNIF1Vl91xg0","email": "reservations@duffel-hotel-group.com","description": "Ornate quarters, some with grand pianos, in a luxurious hotel offering acclaimed dining & a spa.","check_in_information": {"check_out_before_time": "11:30","check_in_before_time": "00:00","check_in_after_time": "14:30"},"chain": {"name": "Duffel Hotel Group"},"brand": {"name": "Duffel Test","id": "bra_0000Alr8BYNsbmDMThHSbI"},"amenities": [{"type": "parking","description": "Parking"}]}}}