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

adults
integer

The number of adult guests travelling

Example: 2
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"
id
string

The ID for this search result

Example: "ssr_0000ASVBuJVLdmqtZDJ4ca"
rooms
integer

The number of rooms required

Example: 1

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: "ssr_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: v1" \
  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"

Response

{
  "data": {
    "rooms": 1,
    "id": "ssr_0000ASVBuJVLdmqtZDJ4ca",
    "check_out_date": "2023-06-07",
    "check_in_date": "2023-06-04",
    "adults": 2,
    "accommodation": {
      "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,
              "payment_type": "pay_now",
              "id": "rat_0000BTVRuKZTavzrZDJ4cb",
              "fee_currency": "GBP",
              "fee_amount": "50.94",
              "due_at_accommodation_currency": "GBP",
              "due_at_accommodation_amount": "39.95",
              "conditions": [
                {
                  "title": "Parking",
                  "description": "Public parking is available nearby for £15 per day"
                }
              ],
              "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",
                  "card"
                ]
              ]
            }
          ],
          "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",
      "name": "The Ritz London",
      "location": {
        "geographic_coordinates": {
          "longitude": -0.1416,
          "latitude": 51.5071
        },
        "address": {
          "region": "England",
          "postal_code": "W1J 9BR",
          "line_one": "150 Piccadilly",
          "country_code": "GB",
          "city_name": "London"
        }
      },
      "key_collection": {
        "instructions": "Please collect the keys from accommodation's reception."
      },
      "id": "acc_0000AWr2IgADo2rTllJJhI",
      "email": "reservations@theritzlondon.com",
      "description": "Ornate quarters, some with grand pianos, in a luxurious hotel offering acclaimed dining & a spa.",
      "created_at": "2022-12-20T15:21:01Z",
      "check_in_information": {
        "check_out_before_time": "11:30",
        "check_in_after_time": "14:30"
      },
      "cheapest_rate_total_amount": "799.00",
      "cheapest_rate_currency": "GBP",
      "chain": {
        "name": "The Ritz-Carlton"
      },
      "amenities": [
        {
          "type": "parking",
          "description": "Parking"
        }
      ]
    }
  }
}