Quotes

The final price and availability check for a list of rates.

accommodation

object

The accommodation associated with this quote

adults

integer

The number of adult guests this quote is for.

Example: 2

base_amount

stringnullable

The base amount for this quote, excluding taxes and fees. Will be null if the base amount is unknown.

Example: "665.83"

base_currency

string

The currency of the base_amount, as an ISO 4217 currency code.

Example: "GBP"

card_component_key

stringnullabledeprecated

A client key to authenticate with Duffel's Card Component when creating a tokenised card. As this is deprecated, prefer to POST /identity/component_client_keys instead.

Example:

"SFMyNTY.g2gDdAAAAANkAAlsaXZlX21vZGVkAAVmYWxzZWQAD29yZ2FuaXNhdGlvbl9pZG0AAAAab3JnXzAwMDA5VWhGY29ERGk5TTFTRjhiS2FkAAtyZXNvdXJjZV9pZG0AAAAab3JxXzAwMDBBVkZWZnFJUXFBWXpYeVRRVlVuBgDpOCvdhwFiAAFRgA.df1RmLeBFUR7r1WFHHiEksilfSZNLhmPX0nj5VOKWJ4"

check_in_date

date

The ISO 8601 date on which the guest wants to check in. This comes from the search request this quote originates from.

Example: "2023-05-24"

check_out_date

date

The ISO 8601 date on which the guest wants to check out. This comes from the search request this quote originates from.

Example: "2023-05-28"

due_at_accommodation_amount

stringnullable

Mandatory fees or taxes that are due by the guest at the accommodation. Depending on the accommodation these may be payable on check in or check out. These fees are not collected during the booking process. Will be null if the amount due at accommodation is unknown.

Example: "39.95"

due_at_accommodation_currency

string

The currency of the due_at_accommodation_amount, as an ISO 4217 currency code.

Example: "GBP"

fee_amount

string

The fee amount for this quote.

Example: "50.94"

fee_currency

string

The currency of the fee_amount, as an ISO 4217 currency code

Example: "GBP"

string

The id of the stay quote

Example: "quo_0000AS0NZdKjjnnHZmSUbI"

rooms

integer

The number of rooms this quote is for

Example: 1

supported_loyalty_programme

enumnullable

The loyalty programme that this quote supports.

Possible values: "wyndham_rewards", "choice_privileges", "marriott_bonvoy", "best_western_rewards", "world_of_hyatt", "hilton_honors", "ihg_one_rewards", "leaders_club", "stash_rewards", "omni_select_guest", "i_prefer", "accor_live_limitless", "my_6", "jumeirah_one", "global_hotel_alliance_discovery", or "duffel_hotel_group_rewards"

tax_amount

stringnullable

The tax amount for this quote. Will be null if the tax amount is unknown.

Example: "133.17"

tax_currency

string

The currency of the tax_amount, as an ISO 4217 currency code.

Example: "GBP"

total_amount

string

The total price for the room for all nights and for all guests. Please note, the guest may be required to pay mandatory fees and taxes at the stay. These are not included in the total_amount, and are included in due_at_accommodation_amount

Example: "799.00"

total_currency

string

The currency of the total_amount, as an ISO 4217 currency code.

Example: "GBP"

Create a quote for a rate

Creates a ready-to-book Duffel Stay Quote — a prospective booking — from a given room rate. This step confirms availability of the rate and total pricing of the booking.

rate_id

stringrequired

The id of the rate you want to book.

Example: "rat_0000ARxBI85qTkbVapZDD2"

Endpoint

POST https://api.duffel.com/stays/quotes

Request


curl -X POST --compressed "https://api.duffel.com/stays/quotes" \
  -H "Accept-Encoding: gzip" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Duffel-Version: v1" \
  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
  -d '{
  "data": {
    "rate_id": "rat_0000ARxBI85qTkbVapZDD2"
  }
}'

{
  "data": {
    "total_currency": "GBP",
    "total_amount": "799.00",
    "tax_currency": "GBP",
    "tax_amount": "133.17",
    "supported_loyalty_programme": "duffel_hotel_group_rewards",
    "rooms": 1,
    "id": "quo_0000AS0NZdKjjnnHZmSUbI",
    "fee_currency": "GBP",
    "fee_amount": "50.94",
    "due_at_accommodation_currency": "GBP",
    "due_at_accommodation_amount": "39.95",
    "check_out_date": "2023-05-28",
    "check_in_date": "2023-05-24",
    "base_currency": "GBP",
    "base_amount": "665.83",
    "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,
              "public_currency": "GBP",
              "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"
        }
      ]
    }
  }
}

Quotes

Schema

Create a quote for a rate

Body parameters