Search Result

A search result is a pending availability for an accommodation on a given check in and check out dates.

Schema

accommodation
object

The accommodation associated with the search result

cheapest_rate_currency
string

The currency for cheapest_rate_total_amount for this accommodation, as an ISO 4217 currency code.

Example: "GBP"
cheapest_rate_public_amount
stringnullable

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.

Example: "899.00"
cheapest_rate_public_currency
stringnullable

The currency for cheapest_rate_public_amount for this accommodation, as an ISO 4217 currency code.

Example: "GBP"
cheapest_rate_total_amount
string

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.

Example: "799.00"
check_in_date
date

The ISO 8601 date on which the guest wants to check in

Example: "2023-05-24"
check_out_date
date

The ISO 8601 date on which the guest wants to check out

Example: "2023-05-28"
guests
listnullable

The list of guests travelling

id
string

The ID for this search result

Example: "srr_0000ASVBuJVLdmqtZDJ4ca"
rooms
integer

The number of rooms required

Example: 1
supported_negotiated_rates
list

The list of negotiated rates supported by this search result. Any negotiated rates in this list were used when searching.

Fetch rates for a search result

Returns complete room and and rate information for the selected search result for a single search result.

URL parameters

search_result_id
stringrequired

The ID of a Duffel Stay Search Result

Example: "srr_0000ARxBI85qTkbVapZMO2"

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_currency": "GBP",
    "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,
      "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"
        }
      ]
    }
  }
}