Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Expedia Group Shopping API

The EPS shopping APIs provide you with access to live rates & availability.

Expedia Group Shopping API is one of 15 APIs that Expedia Group publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Shopping. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 5 paths, and defines 57 schemas. It is described by OpenAPI 3.0.1, at version 1.0.

Requests are made against a single base URL, https://services.expediapartnercentral.com/.

5 operations 5 paths 57 schemas 5 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0
Server
https://services.expediapartnercentral.com/
Authentication
HTTP Basic
Resource Areas
1

Authentication & Security 1

Expedia Group Shopping API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (Basic). By default, every request must be authenticated.

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 5 GET. Each is listed below with its method, path, parameters, and response codes.

Shopping 5

The EPS shopping APIs provide you with access to live rates & availability.

GET
/properties/availability
Expedia Group Get property room rates and availability
getAvailability 26 params → 200400401403426429500503
GET
/properties/{property_id}/availability
Expedia Group Get additional property room rates and availability
getAdditionalAvailability 17 params → 200400401403426429500503
GET
/properties/{property_id}/rooms/{room_id}/rates/{rate_id}
Expedia Group Price-Check
priceCheck 10 params → 200400401403426429500503
GET
/properties/{property_id}/payment-options
Expedia Group Get Accepted Payment Types - EPS MOR Only
getPaymentOptions 7 params → 200400404426429500503
GET
/calendars/availability
Expedia Group Get a calendar of availability dates for properties. This is currently a Vrbo property only feature.
getCalendarAvailability 8 params → 200400401403426429500503

Schemas 57

The contract defines 57 schemas that model the data the API accepts and returns. The most detailed are Rate (18 properties), Totals (10 properties), RoomPriceCheck (10 properties), TraderAddress (7 properties). Each schema is shown below with its type and property counts.

Deal
object
The deal that applies to this rate.
2 properties
Link
object
An individual link.
3 properties
TraderDetails
array
An array of traders.
BedGroupConfiguration
object
An individual bed configuration.
3 properties
StayConstraints
object
2 properties
PaymentOption
object
The payment option response.
2 properties
FeesPricingInformation
object
The fees collected by the property. The values for each type of fee are the total for that type. Mandatory fees are collected by the property at check-in or ch…
3 properties
ErrorIndividual
object
An individual error.
3 properties
RateLinks
object
A map of links, including a link to request payment options.
1 property
TraderTermsAndConditions
string
The url linking to the full text terms and conditions.
TraderAddress
object
The trader address.
7 properties
MerchantOfRecord
string
expedia - Payment is taken by Expedia. property - Payment is taken by the property.
TraderName
string
The trader name.
Status
string
Indicates the status of the rate. If the rate is still available then available will be returned. If the rate is no longer available at that price then pricech…
PropertyAvailabilityLinks
object
A map of links, including links to request additional rates. Note that the recommendations feature has been retired and will return an error if the link is fol…
2 properties
Amount
object
The monetary amount.
2 properties
Error
object
The overall class of error that occured.
4 properties
Property
object
3 properties
CheckOutValidity
string
Enumeration indicating the capability of check-out on the date. CHECKOUTVALID: The associated date is valid for check out. CHECKOUTINVALID: The checkout validi…
OfferType
string
The type of offer this value add promotion is.
TraderInformation
object
The professional entity or entities that sells the property inventory or related services.
2 properties 1 required
RoomPriceCheckLinks
object
A map of links, including links to continue booking this rate or to shop for additional rates. If this rate is still available for booking then a book link wil…
4 properties
NightChargeType
string
The price breakout type. baserate - The room rate without any taxes and fees applied. taxandservicefee - Tax recovery charges, service fees, and taxes. Ensure…
CreditCard
object
3 properties
CardOption
object
2 properties
Totals
object
The total price of charges, given various criteria. inclusive - provides the total price including taxes and fees. This does not include property collected fee…
10 properties
ChargeCalculated
object
An object representing a charge. Information about the charge is provided in both the billable currency and the request currency.
2 properties
AffiliateCollect
object
This option will be returned if a booking can be made using Expedia Affiliate Collect.
1 property
SaleScenario
object
Provides the special scenarios that need to be taken into account when using this rate.
5 properties
BedGroupAvailabilityLinks
object
A map of links, including links to confirm pricing and availability for the selected rate.
1 property
Deposit
object
A deposit policy associated with the rate.
3 properties
Field
object
An individual field that had an error.
3 properties
Frequency
string
The frequency of when this applies.
Stay
object
3 properties
PropertyCalendarAvailability
object
2 properties
TraderRightToWithdrawMessage
string
The trader right to withdraw message.
Rate
object
A rate.
18 properties
CancelPenalty
object
6 properties
NonrefundableDateRange
object
2 properties
StatusPriceCheck
string
Indicates the status of the rate. If the rate is still available then available will be returned. If the rate is no longer available at that price then pricech…
RoomPriceCheck
object
The price check response.
10 properties
ValueAdd
object
An individual value add.
6 properties
Promotions
object
Available promotions that apply to this rate.
2 properties
Charge
object
An object representing a charge. Information about the charge is provided in both the billable currency and the request currency.
2 properties
RoomAvailability
object
The room information.
3 properties
Day
object
5 properties
CategoryValueAdd
string
The general category that this value add promotion falls into.
PricingInformation
object
The pricing information object.
4 properties
Amenity
object
An individual amenity.
4 properties
NightCharge
object
3 properties
MarketingFeeIncentive
object
An object representing one incentive source and the stay dates relevant to that particular incentive.
3 properties
StayType
string
The price breakout type.
CheckInValidity
string
Enumeration indicating the capability of check-in on the date. CHECKINVALID: The associated date is valid for check in. CHECKININVALID: Generic or Unknown reas…
TraderContactMessage
string
The trader contact message.
PropertyAvailability
BedGroupAvailability
object
4 properties
CreditCardMerchant
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

expedia-group-shopping-api-openapi.yml Raw ↑

Other APIs Expedia Group publishes across the network.

Expedia Group Bookings API
Expedia Group Content API
Expedia Group Deposit API
Expedia Group Geography API
Expedia Group Loyalty API
Expedia Group Manage Booking API
Expedia Group Notifications API
Expedia Group OrderPurchaseScreen API
Expedia Group OrderPurchaseUpdate API
Expedia Group Property API
Expedia Group Rate Plan API
Expedia Group Rate Verification Thresholds API