Lodging Quotes API

Guidance and examples for accessing the Lodging Quotes API

The Lodging Quotes API will return the price and availability information for selected Expedia lodging property IDs.

Endpoint

Method	Endpoint
GET	https://apim.expedia.com/lodging/quotes

Required Headers

Key:	Expedia API key
Authorization:	Expedia API Authorization String
Accept:	application/vnd.exp-lodging.v3+json
Partner-Transaction-Id:	[Partner TransactionID String]

Example Quotes API Request

Request

https://apim.expedia.com/lodging/quotes?links=WS,WD&propertyIds=87704892,46330564,31187403,76252345&checkIn=2024-11-29&checkOut=2024-12-04

Response

{
    "Count": 4,
    "TotalPropertyCount": 4,
    "TransactionId": "0e1d7193-2289-481c-bdf9-b7ac0b0b3bfe",
    "StayDates": {
        "CheckInDate": "2024-11-29",
        "CheckOutDate": "2024-12-04"
    },
    "LengthOfStay": 5,
    "Occupants": [
        {
            "Adults": 2
        }
    ],
    "Properties": [
        {
            "Id": "87704892",
            "Status": "AVAILABLE",
            "RoomTypes": [
                {
                    "RatePlans": [
                        {
                            "CancellationPolicy": {
                                "Refundable": true,
                                "FreeCancellation": true,
                                "FreeCancellationEndDateTime": "2024-11-15T23:59:00-08:00",
                                "CancellationPenaltyRules": [
                                    {
                                        "PenaltyPercentOfStay": "50.00",
                                        "PenaltyStartDateTime": "2024-11-15T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-22T23:59:00-08:00"
                                    },
                                    {
                                        "PenaltyPercentOfStay": "100",
                                        "PenaltyStartDateTime": "2024-11-22T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-29T00:00:00-08:00"
                                    }
                                ]
                            }
                        }
                    ],
                    "Price": {
                        "BaseRate": {
                            "Value": "790.00",
                            "Currency": "USD"
                        },
                        "TaxesAndFees": {
                            "Value": "348.48",
                            "Currency": "USD"
                        },
                        "TotalPrice": {
                            "Value": "1138.48",
                            "Currency": "USD"
                        },
                        "AvgNightlyRate": {
                            "Value": "158.00",
                            "Currency": "USD"
                        },
                        "AvgNightlyRateWithFees": {
                            "Value": "198.80",
                            "Currency": "USD"
                        },
                        "TotalPriceWithPropertyFees": {
                            "Value": "1138.48",
                            "Currency": "USD"
                        }
                    },
                    "Links": {
                        "WebSearchResult": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/search?selected=87704892&startDate=2024-11-29&endDate=2024-12-04&adults=2&tpid=9001&eapid=1&mpa=790.00&mpb=348.48&mpd=USD"
                        },
                        "WebDetails": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/3032772?adults=2&startDate=2024-11-29&endDate=2024-12-04"
                        }
                    }
                }
            ]
        },
        {
            "Id": "46330564",
            "Status": "AVAILABLE",
            "RoomTypes": [
                {
                    "RatePlans": [
                        {
                            "CancellationPolicy": {
                                "Refundable": true,
                                "FreeCancellation": true,
                                "FreeCancellationEndDateTime": "2024-11-15T23:59:00-08:00",
                                "CancellationPenaltyRules": [
                                    {
                                        "PenaltyPercentOfStay": "50.00",
                                        "PenaltyStartDateTime": "2024-11-15T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-22T23:59:00-08:00"
                                    },
                                    {
                                        "PenaltyPercentOfStay": "100",
                                        "PenaltyStartDateTime": "2024-11-22T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-29T00:00:00-08:00"
                                    }
                                ]
                            }
                        }
                    ],
                    "Price": {
                        "BaseRate": {
                            "Value": "525.00",
                            "Currency": "USD"
                        },
                        "TaxesAndFees": {
                            "Value": "197.97",
                            "Currency": "USD"
                        },
                        "TotalPrice": {
                            "Value": "722.97",
                            "Currency": "USD"
                        },
                        "AvgNightlyRate": {
                            "Value": "105.00",
                            "Currency": "USD"
                        },
                        "AvgNightlyRateWithFees": {
                            "Value": "130.20",
                            "Currency": "USD"
                        },
                        "TotalPriceWithPropertyFees": {
                            "Value": "722.97",
                            "Currency": "USD"
                        }
                    },
                    "Links": {
                        "WebSearchResult": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/search?selected=46330564&startDate=2024-11-29&endDate=2024-12-04&adults=2&tpid=9001&eapid=1&mpa=525.00&mpb=197.97&mpd=USD"
                        },
                        "WebDetails": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/1896742?adults=2&startDate=2024-11-29&endDate=2024-12-04"
                        }
                    }
                }
            ]
        },
        {
            "Id": "31187403",
            "Status": "AVAILABLE",
            "RoomTypes": [
                {
                    "RatePlans": [
                        {
                            "CancellationPolicy": {
                                "Refundable": true,
                                "FreeCancellation": true,
                                "FreeCancellationEndDateTime": "2024-10-30T23:59:00-07:00",
                                "CancellationPenaltyRules": [
                                    {
                                        "PenaltyPercentOfStay": "50.00",
                                        "PenaltyStartDateTime": "2024-10-30T23:59:00-07:00",
                                        "PenaltyEndDateTime": "2024-11-15T23:59:00-08:00"
                                    },
                                    {
                                        "PenaltyPercentOfStay": "100",
                                        "PenaltyStartDateTime": "2024-11-15T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-29T00:00:00-08:00"
                                    }
                                ]
                            }
                        }
                    ],
                    "Price": {
                        "BaseRate": {
                            "Value": "825.00",
                            "Currency": "USD"
                        },
                        "TaxesAndFees": {
                            "Value": "337.65",
                            "Currency": "USD"
                        },
                        "TotalPrice": {
                            "Value": "1162.65",
                            "Currency": "USD"
                        },
                        "AvgNightlyRate": {
                            "Value": "165.00",
                            "Currency": "USD"
                        },
                        "AvgNightlyRateWithFees": {
                            "Value": "203.00",
                            "Currency": "USD"
                        },
                        "TotalPriceWithPropertyFees": {
                            "Value": "1162.65",
                            "Currency": "USD"
                        }
                    },
                    "Links": {
                        "WebSearchResult": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/search?selected=31187403&startDate=2024-11-29&endDate=2024-12-04&adults=2&tpid=9001&eapid=1&mpa=825.00&mpb=337.65&mpd=USD"
                        },
                        "WebDetails": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/364168?adults=2&startDate=2024-11-29&endDate=2024-12-04"
                        }
                    }
                }
            ]
        },
        {
            "Id": "76252345",
            "Status": "AVAILABLE",
            "RoomTypes": [
                {
                    "RatePlans": [
                        {
                            "CancellationPolicy": {
                                "Refundable": true,
                                "FreeCancellation": true,
                                "FreeCancellationEndDateTime": "2024-11-15T23:59:00-08:00",
                                "CancellationPenaltyRules": [
                                    {
                                        "PenaltyPercentOfStay": "50.00",
                                        "PenaltyStartDateTime": "2024-11-15T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-22T23:59:00-08:00"
                                    },
                                    {
                                        "PenaltyPercentOfStay": "100",
                                        "PenaltyStartDateTime": "2024-11-22T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-29T00:00:00-08:00"
                                    }
                                ]
                            }
                        }
                    ],
                    "Price": {
                        "BaseRate": {
                            "Value": "800.00",
                            "Currency": "USD"
                        },
                        "TaxesAndFees": {
                            "Value": "515.12",
                            "Currency": "USD"
                        },
                        "TotalPrice": {
                            "Value": "1315.12",
                            "Currency": "USD"
                        },
                        "AvgNightlyRate": {
                            "Value": "160.00",
                            "Currency": "USD"
                        },
                        "AvgNightlyRateWithFees": {
                            "Value": "227.16",
                            "Currency": "USD"
                        },
                        "TotalPriceWithPropertyFees": {
                            "Value": "1315.12",
                            "Currency": "USD"
                        }
                    },
                    "Links": {
                        "WebSearchResult": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/search?selected=76252345&startDate=2024-11-29&endDate=2024-12-04&adults=2&tpid=9001&eapid=1&mpa=800.00&mpb=515.12&mpd=USD"
                        },
                        "WebDetails": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/2695601?adults=2&startDate=2024-11-29&endDate=2024-12-04"
                        }
                    }
                }
            ]
        }
    ]
}

Supported Points of Sale

Only the following Points of Sale are supported:

	POS	Currency Code	Locale	Base Site URL
1	AU	AUD	en_AU	www.stayz.com.au
2	BR	BRL	pt_BR	www.vrbo.com/pt-br
3	CA	CAD	en_CA	www.vrbo.com/en-ca
4	CA	CAD	fr_CA	www.vrbo.com/fr-ca
5	DE	EUR	de_DE	www.fewo-direkt.de
6	ES	EUR	es_ES	www.vrbo.com/es-es
7	FR	EUR	fr_FR	www.abritel.fr
8	UK	GBP	en_GB	www.vrbo.com/en-gb
9	IT	EUR	it_IT	www.vrbo.com/it-it
10	NL	EUR	nl_NL	www.vrbo.com/nl-nl
11	US	USD	en_US	www.vrbo.com
12	AT	EUR	de_AT	www.vrbo.com/de-at
13	DK	DKK	da_DK	www.vrbo.com/da-dk
14	FI	EUR	fi_FI	www.vrbo.com/fi-fi
15	GR	EUR	el_GR	www.vrbo.com/el-gr
16	JP	JPY	ja_JP	www.vrbo.com/ja-jp
17	NO	NOK	nb_NO	www.vrbo.com/no-no
18	NZ	NZD	en_NZ	www.bookabach.co.nz
19	PT	EUR	pt_PT	www.vrbo.com/pt-pt
20	SE	SEK	sv_SE	www.vrbo.com/sv-se
21	SG	SGD	en_SG	www.vrbo.com/en-sg
22	MX	MXN	es_MX	www.vrbo.com/es-mx
23	PL	PLN	pl_PL	www.vrbo.com/pl-pl

Supported Currencies

For the first release of the Quotes API, only the following currencies are supported:

ARS	AUD	BRL	CAD	CHF	CNY	COP
CZK	DKK	EUR	GBP	HKD	HRK	HUF
IDR	ILS	INR	JPY	KRW	MXN	MYR
NOK	NZD	PLN	RUB	SEK	SGD	THB
USD	ZAR	TRY

Error Codes

Common Error Codes

HTTP Status Code	Error Code	Error Response	Cause
500	APPLICATION_ERROR	Application error.	Application error.
200	NO_RESULTS_FOUND	Sorry, your query completed successfully, but did not return any inventory. Please adjust your search parameters and try again.	No property found.
400	QUOTES_SEARCH_CRITERIA_INCOMPLETE	Quotes search criteria are incomplete. Please specify the following search criteria together: [propertyIds, checkIn, checkOut]	Missing required request parameter.
400	INVALID_PROPERTYIDS	The propertyIds is invalid, which contains invalid id [%s]	Please specify correct Expedia property IDs. Available Expedia property ID list could be found in Related Links section below.
400	TOO_MANY_PROPERTYIDS	Too many property IDs. Please specify up to 1000 property IDs in Expedia property IDs.	Requested too many properties.
400	INVALID_CHECKIN	The checkIn is in invalid. The format should be 'YYYY-MM-DD'.	The format of checkIn is invalid.
400	INVALID_PRICE	The price is invalid. Allowed value is a number.	Price is not a number
400	INVALID_CHECKOUT	The checkOut is invalid. The format should be 'YYYY-MM-DD'.	The format of checkOut is invalid.
400	CHECKOUT_EARLIER_THAN_CHECKIN	The checkout date must occur after checkin date.	The checkout date must occur after checkin date.
400	CHECKIN_IN_THE_PAST	The checkIn should not be in the past.	The checkIn should not be in the past.
400	SEARCH_WINDOW_OUT_OF_RANGE	Search window is too large. Maximum length of stay is %d days.	Search window is too large.
400	CHECKOUT_OUT_OF_RANGE	The checkOut is out of range. Checkout date can only occur up to %d days in the future.	The checkOut is out of range.
400	UNSUPPORTED_CURRENCY	The currency is invalid. The requested currency is not supported.	The given currency is not supported.
400	TOO_MANY_ROOMS	Requested too many rooms. Please search up to 8 rooms.	Requested too many rooms.
400	INVALID_ADULTS	Invalid adult number detected. Allowed value is a number.	Please specify correct adult number.
400	ADULTS_OUT_OF_RANGE	Too many adults. The number of adults should not be greater than 99.	Requested too many adults.
400	ROOM_NUMBER_NOT_IN_SEQUENTIAL	Room numbers of adults invalid. Room numbers should be in numeric sequential and start from 1.	Please specify adult number for each desired room. For example, do not specify room1.adults=2&room3.adults=3 only without specifying room2.adults.
400	INVALID_ROOM_OCCUPANTS	Only childAges specified. Adults info is mandatory for each room.	Children should be accompanied by adults for each room.
400	INVALID_CHILDAGES	Invalid child occupants detected. Each child age should be a number of less than 17 and child count of any room should be less than %d.	Child age is not a number, or child age is out of range, or children number exceeded the maximum allowed number.
400	INVALID_LINKS	The links is invalid. The links could be any set of WD, WS separated by comma.	Please specify correct links.
400	INVALID_CLIENT_KEY	Invalid client key: %s.	Key in request header is invalid or too many Keys in header.
400	INVALID_ACCEPT	Please provide a valid Accept header.	Accept in request header is invalid or too many Accepts in header.
400	INVALID_PARTNER_TRANSACTION_ID	Partner-Transaction-Id is missing.	Partner-Transaction-Id in request header is empty.

Here, you can explore the endpoint definitions for this API, then go to the API Explorer to try out all the XAP endpoints, download OpenAPI specs, or download our Postman collections. Testing with one or all of these options will give you an understanding of how the examples and schema definitions compare to the actual output.

ARS	AUD	BRL	CAD	CHF	CNY	COP
CZK	DKK	EUR	GBP	HKD	HRK	HUF
IDR	ILS	INR	JPY	KRW	MXN	MYR
NOK	NZD	PLN	RUB	SEK	SGD	THB
USD	ZAR	TRY

ARS	AUD	BRL	CAD	CHF	CNY	COP
CZK	DKK	EUR	GBP	HKD	HRK	HUF
IDR	ILS	INR	JPY	KRW	MXN	MYR
NOK	NZD	PLN	RUB	SEK	SGD	THB
USD	ZAR	TRY

ARS	AUD	BRL	CAD	CHF	CNY	COP
CZK	DKK	EUR	GBP	HKD	HRK	HUF
IDR	ILS	INR	JPY	KRW	MXN	MYR
NOK	NZD	PLN	RUB	SEK	SGD	THB
USD	ZAR	TRY