Availability and rates APIs
Booking APIs
Property mgmt APIs
Developer Tools
Recent changesAPI change log
MessagingMay 2025

New message type was added (CANCEL_WAIVER_RESOLVED) to indicate when a cancellation waiver is resolved.

Property statusMay 2025

The following limits are now in place for address fields:

  • Address line 1 - 2-80 characters are supported
  • Address line 2 - 1-80 characters are supported
  • City - 2-80 characters are supported
  • State or province - 2-40 characters are supported
  • Postal code - 6-20 characters are supported
Property APIMay 2025

The following limits are now in place for address fields:

  • Address line 1 - 2-80 characters are supported
  • Address line 2 - 1-80 characters are supported
  • City - 2-80 characters are supported
  • State or province - 2-40 characters are supported
  • Postal code - 6-20 characters are supported
Product APIApril 2025

Updated the list of accepted value-adds for standalone and package rate plans.

Property APIApril 2025Payments APIApril 2025

Released the initial version of the Payments API.

Reservation management capabilityApril 2025

  • Released enhancements to reservation retrieval:

    • supplierAmount has been replace by the amounts object on Reservation; amounts returns comprehensive, detailed reservation amount values
    • paymentInstructions has been replaced by the payment : instructions object on the Reservations object
    • payment : instrument and payment : installments is now available on the Reservation object to retrieve credit card, EVC, and payment information
    • cancellationPolicy object was added to the Reservation object to retrieve the cancellation policy that was in place when the reservation was made

  • payment : installments object was added to the Reservation object so you can retrieve the payment schedule used to collect payment for the reservation

  • remittanceType object was added to the Reservation object to indicate the remittance type used for a reservation

  • supplierOperatingModel was added to the Reservation object to indicate the operation model of the lodging partner

  • affiliateSource and invoicing fields added, to support corporate travelers

  • itineraryReference field was added to the ReservationAlternativeIds object to enable partners to pass itinerary IDs to travelers

  • Introduced enhancements to reservation update:

    • Added the reason input argument to the changeReservationReconciliation mutation
    • Added the refundReservation mutation to enable partners to refund a reservation's rate on or after a reservation’s check-in date

  • Introduced reservation delivery, which includes

Sandbox Data Management APIApril 18, 2025
  • On CreateReservationInput object: Changed type of primaryGuest field from PrimaryGuestInput to GuestInput
  • Renamed PrimaryGuestInput to GuestInput and added the companyName and corporateTravelPurpose fields
  • On the InvoicingInput object: Removed the pointOfSaleDisplay field
  • On the PaymentInstrumentTypeInput enumeration: Added the AFFILIATE_VIRTUAL_CARD value
  • Added the ReservationPaymentStatus enumeration
  • Added the TravelPurpose enumeration
Sandbox Data Management APIApril 2, 2025
  • Released the initial version of the Sandbox API.
Product APIMarch 2025

Added the Japanese-style value to the roomClassEnum enumeration.

Property statusFebruary 2025

Special check-in instructions (specified by the Property API's SPECIAL_CHECKIN_INSTRUCTIONS field) are no longer considered as part of the HasCheckInInstructions checkpoint.

Product APIJanuary 2025

New featured amenities (featuredAmenityEnum) added:

  • Air Conditioning
  • Housekeeping
  • No Housekeeping
  • Pets Allowed
  • Pets Not Allowed

Updated featured amenities (featuredAmenityEnum):

  • Business Lounge Access is now Club Lounge Access

Deprecated featured amenities (featuredAmenityEnum):

  • Concierge Service

Deprecated room views (viewEnum) from the Room Name attribute:

  • Multiple View
  • No View
  • Partial View
  • View
Booking Notification APINovember 2024

Added support for affiliate (corporate) credit cards for Hotel Collect bookings. The <SpecialRequests> element (RequestCode=5) can now include guest-handling instructions that include corporate reservation information.

Booking Retrieval and Confirmation APIsNovember 2024

Added support for affiliate (corporate) credit cards for Hotel Collect bookings. The <SpecialRequests> element (code=5) can now include guest-handling instructions that include corporate reservation information.

Product APINovember 2024

"Full Kitchen" has been deprecated as a value-add for standalone and corporate rate plans (in favor of relying only on room amenities to indicate kitchens).

Reservation management capabilityNovember 2024
  • Added the clientMutationId field to all mutation input and payload objects.
  • Added the companyName field to the Guest object, to enable partners to retrieve the company a guest works for.
Notifications (webhooks)October 2024

  • The refreshNotificationCallbackConfigSecret mutation now enables you to specify whether the new secret is used immediately or whether it is persisted for 3 more days (if the secret is refreshed more than 3 days before expiration). In addition, a new HTTP notification header called x-eg-notification-signature-v2 was added to replace the x-eg-notification-signature header.

  • message_attributes attribute was added to the MessageAttributesUpdated notification payload.

Reservation management capabilityOctober 2024

Type changed from Int to String for SupplierLoyaltyPlanInfo : membershipNumber.

MessagingSeptember 2024

Removed support for GIF attachment types.

Notifications (webhooks)August 2024

An email address (contactEmail) must now be configured when creating a callback configuration using the createNotificationCallbackConfig mutation. The email address is used to send email notifications when the callback configuration's secret is about to expire (sent 30 days, 7 days, and 1 days prior to expiration).

Reservation management capabilityAugust 2024

Deprecated the paymentInstructions field on the Reservation object. Use payment : instructions instead.

MessagingJuly 2024

To maintain the security of our platform and continue building trust with our lodging partners and travelers, we are implementing a new moderation process where a subset of Expedia Group messages may be flagged and held for review before being released. Two enhancements were introduced:

  • Added the reviewStatus field to the MessageThreadMessage object, to indicate a review's status as it goes through moderation. "In Review" indicates that a message is currently being reviewed (could take up to 24 hours), "Approved" indicates that the message has been approved, and "Blocked" indicates that the message contains offending material or links.
  • MessageAttributesUpdated event type was added to send a webhook notification when a message's review status changes.
Notifications (webhooks)July 2024

MessageAttributesUpdated event type was added to send a notification when a message's review status changes.

MessagingJune 2024

When retrieving message threads, you can now specify whether they are returning in ascending or descending order based on creation date. The orderBy input parameter is now available. You can also specify the order of messages that are retrieved using the messageThread query.

Notifications (webhooks)June 2024

  • An email address (contactEmail) can now be configured for each callback configuration. The email address is used to send email notifications when the callback configuration's secret is about to expire (sent 30 days, 7 days, and 1 days prior to expiration).

  • The undeliveredNotifications query is now available, to retrieve any undelivered notifications for a given event type.

Reviews capabilityJune 2024
  • Added the ability to filter reviews by brand (Expedia site where the review was collected) when using the reviews query. The brandNames field was added to the ReviewFilter input type to support this. In addition, the brandName field in the Review object has been deprecated; use the new brandNameV2 field instead when retrieving reviews.
  • pageSize argument's limit (for the reviews query) has been increased, enabling you to retrieve up to 100 reviews per page of results.
Reviews capabilityApril 2024

Added the aggregatedReviews query to enable partners to retrieve average ratings for reviews collected on Expedia brand sites.

MessagingMarch 2024

Released the initial version of the messaging capability of the Lodging Partner GraphQL API.

Notifications (webhooks)February 2024

Property status notifications added.

Reservation management capabilityJanuary 2024

Added the travelPurpose field to the Guest object (in the reservation management capability) to enable partners to identify the reason for a guest's reservation.

Reservation management capabilityDecember 2023

Added the cancelReservation mutation to reservation management capability to enable partners to cancel reservations on or before a reservation’s check-in date.

Property APINovember 28, 2023

Updated the enumerations list with new tattoo restrictions.

Notifications (webhooks)November 2023

Added the sendTestNotification mutation to the capability, which enables partners to send a test notification to their callback URL.

Reservation management capabilityOctober 2023

The following types have been added or updated to bring the API into parity with EPC:

  • Guest : phoneNumbers
  • SupplierLoyaltyPlanInfo : planCode
  • SupplierLoyaltyPlanInfo : membershipNumber
  • Reservation : childAges
  • Reservation : tidsCode
  • Guest : emailAddress

In addition, these fields have been deprecated:

  • Reservation : loyaltyTier (loyaltyTier is now in the Guest object)
  • Reservation : guestContact (replaced by primaryGuest)

For more information, refer to the reservations query.

Compliance capabilityAugust 2023

Added the following values to the RegistrationNumberType enumeration to support DAC7 (European regulatory mandate that enforces annual reporting obligations for digital online platforms, crypto-assets and e-money):

  • ENTITY_TYPE
  • IS_TRADED
  • IS_GOVERNMENT_ENTITY
  • IS_ADDRESS_IN_EU
  • IS_RESIDENCE_IN_EU
  • LEGAL_ADDRESS
  • ISSUED_TAX_ID
  • PERMANENT_ESTABLISHMENT_COUNTRY
  • BUSINESS_REGISTRATION_NUMBER
  • LAND_REGISTRATION_NUMBER
  • BIRTH_DATE
  • IS_VAT_REGISTERED
  • VAT_ID

In addition, the IS_CONDITION and HOUSE_NUMBER values were added to support properties in jurisdictions of France, San Diego, London, and Tasmania. AUSTRALIAN_BUSINESS_NUMBER was added to support properties in Australia.

Notifications (webhooks)June 2023

Released the initial version of the notifications capability.

Reviews capabilityJune 2023

Released the initial version of the reviews capability of the Lodging Partner GraphQL API.

Property APIMarch 24, 2023

Updating PET_POLICY notes to reflect the legal guidelines.

Reservation management capabilityMarch 2023

Added the guestContact object, reconciliationType field, and isReconciled field to the reservations query.

Property APIMarch 15, 2023

Updated the enumerations list to include accessibility attributes.

Property APIMarch 04, 2023

Update languages spoken section to take out CHINESE and replace it with MANDARIN and CANTONESE.

Product APIJanuary 2023

Added new error code 3027 to ensure strict Per Person fees validation for a same age category in a given duration.

Reservation management capabilityDecember 2022

Added the reservation update feature to the reservation management capability, which added the cancelReservationReconciliation and changeReservationReconciliation mutations.

Compliance capabilityNovember 2022

Released the initial version of the compliance capability.

Image APINovember 2022

Updated GET request to include pagination, which enables partners to call for lists of images beyond the first 1000 active images.

Property statusNovember 2022

Released the initial version of the property status capability of the Lodging Partner GraphQL API.

Reservation management capabilityNovember 2022
  • Added the lastUpdatedDateTime filter to the reservations query, enabling partners to backload reservation data for reservation events that were impacted by a delivery connection outage.
  • Added the loyaltyTier field to the Reservation object to enable partners to retrieve guest loyalty tier.
  • Added the accessibilityText field to the Reservation object to enable partners to retrieve accessibility requests made by the guest for the reservation.
  • Added the valueAddedPromotions field to the Reservation object, enabling partners to retrieve value add promotions (VAP) used to book the reservation.
  • Removed checkInTime, checkOutTime, petCount, and paymentSchedule from the Reservation object.
  • Removed emailAddressandphoneNumberfrom theGuest` object.
Property APINovember 03, 2022

Deprecated freeform text paragraphs in Property API. We strongly recommend the use of structured attributes to ensure important information is surfaced appropriately.

Image APIOct 2022

Updated error codes list with two new codes, 3806 and 3807.

Promotions capabilityOctober 2022

Updated endpoints:

  • Token service, from https://apis.expediaconnectivity.com/oauth/token to https://api.expediagroup.com/identity/oauth2/v3/token
  • API endpoint, from https://apis.expediaconnectivity.com/graphql to https://api.expediagroup.com/supply/lodging/graphql

Schema changes:

  • Property : geoLocation is deprecated and replaced with coordinates
  • Address : city is deprecated and replaced with locality
  • Address : country is deprecated and replaced with countryCode
  • Address : line1, line2, line3 are deprecated and replaced with addressLines
  • Address : province is deprecated and replaced with administrativeArea
  • sublocality field added to the Address object
Reservation management capabilityOctober 2022

Updated endpoints:

  • Token service, from https://apis.expediaconnectivity.com/oauth/token to https://api.expediagroup.com/identity/oauth2/v3/token
  • API endpoint, from https://apis.expediaconnectivity.com/graphql to https://api.expediagroup.com/supply/lodging/graphql

Schema changes:

  • Property : geoLocation is deprecated and replaced with coordinates
  • Address : city is deprecated and replaced with locality
  • Address : country is deprecated and replaced with countryCode
  • Address : line1, line2, line3 are deprecated and replaced with addressLines
  • Address : province is deprecated and replaced with administrativeArea
  • sublocality field added to the Address object
Property APIAugust 26, 2022

Documentation has been updated to move the following amenities from Mandatory fees to Policies. They were moved because they would not sync in our system when sent as mandatory fees.

  • NO_CLEANING_FEE
  • CLEANING_FEE_IN_RATE
  • CLUB_CARD_FEE_IN_RATE
  • DESTINATION_FEE_IN_RATE
  • FACILITIES_FEE_IN_RATE
  • NO_RESORT_FEE
  • TRANSFER_FEE_IN_RATE
  • SANITATION_FEE_IN_RATE
  • TOWELS_SHEETS_FEE_IN_RATE
  • UTILITY_FEE_IN_RATE
  • SEASONAL_HEATING_IN_RATE

In addition, CLEANING_FEES_OPTIONAL_AMOUNT_VARIES_BY_UNIT was moved from Optional fees to Policies.

The following parking codes were missing from the documentation and have been added to Property amenities, under "Parking and transportation amenities":

  • VALET_PARKING (FREE)
  • NO_ELECTRIC_CAR_CHARGING_STATION

Finally, the documentation was updated to indicate that partners must send PET_FEE + scope + duration, if a surcharge must be displayed. See the "Other policies in effect at a property" section of Policies.

Promotions capabilityApril 2022

Support for "evergreen" promotions was added, to enable partners to create promotions with no end date. To do this, specify these restrictions: "bookingLocalDateTimeTo": "2079-06-06T23:59:00" and "travelDateTo": "2079-06-06"

Reservation management capabilityFebruary 2022

Added the reservation ID filter to the reservations query, enabling partners to query for reservations based on ID.

Product APINovember 2021

Added new error codes 3083 and 3089 to ensure strict Cancelation Penalty validations in RatePlan level.

Product APINovember 2021

Allowed amenity PUT, amenity GET, and rateThresholds endpoints to receive and return v3 amenity content type.

Product APIOctober 2021

Maximum number of cancellation policy exceptions was reduced from 200 to 50.

Reservation management capabilityOctober 2021

Added reconciliationEligibility to the Reservation type to enable partners to determine whether a reservation can be reconciled (using the reservation reconciliation capability).

Product APISeptember 2021

Maximum number of cancellation policy exceptions was reduced from 500 to 200.

Property APISeptember 14, 2021

Added enumerations to support bulk media scraping.

Promotions capabilityAugust 2021

Added isContractedPromotion to the Promotion interface and DiscountPromotion type to enable partners to determine whether a promotion was negotiated. Negotiated promotions can be queried but not changed.

Promotions capabilityJuly 2021

Added sellStatus to the Promotion interface and DiscountPromotion type to enable partners to query for a promotion's sell status (whether the promotion is currently bookable based on the its reservation date/time range.)

Deposit APIJune 2021

Added cap for Deposit Percentage to not exceed 50% for Expedia Traveler Preference properties. Updated the error message section with new error code 3032 which is returned when Deposit percentage exceed 50%.

Image APIMay 2021

Updated request and best practice information to note that only the first 1,000 active images are returned during a GET of all images.

Reservation management capabilityMay 2021

Released the initial version of the reservation retrieval feature of the reservation management capability of the Lodging Partner GraphQL API.

Property APIApril 20, 2021

Added MOBILE_HOME to the Enumeration list of supported structure type.

Image APIMarch 2021

Updated the categoryCodesEnum list with new Category Codes for Wardrobe, Elevator, Cleanliness standards, Property map, Pet-friendly amenities, Capsule, In-room fitness, Wardrobe, and Surfing/boogie boarding.

Promotions capabilityMarch 2021

The Date type was renamed LocalDate, and the DateTime type is now LocalDateTime. This affects the promotions capability. Here is a summary of the schema changes:

  • BlackoutDateRange object: travelDateFrom and travelDateTo now use the LocalDate type (from Date)
  • BlackoutDateRangeInput input object: travelDateFrom and travelDateTo now use the LocalDate type (from Date)
  • BookingLocalDateTimeInput object: from and to now use the LocalDateTime type (from DateTime)
  • CheckoutDateFilter input object: from and to now use the LocalDate type (from String)
  • Reservation object: checkInDate and checkOutDate now use the LocalDate type (from String)
  • Restrictions object:
    • bookingLocalDateTimeFrom and bookingLocalDateTimeTo now use the LocalDateTime type (from DateTime)
    • travelDateFrom and travelDateTo now use the LocalDate type (from Date)
  • RestrictionsCreateInput input object:
    • bookingLocalDateTimeFrom and bookingLocalDateTimeTo now use the LocalDateTime type (from DateTime) -travelDateFrom and travelDateTo now use the LocalDate type (from Date)
  • RestrictionsUpdateInput input object:
    • bookingLocalDateTimeFrom and bookingLocalDateTimeTo now use the LocalDateTime type (from DateTime)
    • travelDateFrom and travelDateTo now use the LocalDate type (from Date)
  • Restrictions object: travelDateFrom and travelDateTo now use the LocalDate type (from Date)
  • SupplierRate object: fromDate and toDate now use the LocalDate type (from String)
  • TravelDateInput input object: from and to now use the LocalDate type (from Date)
Property APIMarch 18, 2021

Added additional amenities under Enhanced Cleaning and Traveler Safety.

Property APIMarch 05, 2021

Added warning codes under Error handling section.

Product APIFebruary 8, 2021

Updated support of custom cancellation policy.

Property APIJanuary 25, 2021
  • Added enumerations under Property API Policy section to support ONLINE_REGISTRATION_REQUIRED_BEFORE_ARRIVAL, GOVERNMENT_ISSUED_ID_REQUIRED_BEFORE_ARRIVAL and PASSPORT_COPY_REQUIRED_BEFORE_ARRIVAL.
  • Added CLEANING_FEE_OPTIONAL enumeration under Property API Optional Fees section to support Optional Cleaning Fees.
  • Added STROLLER enumeration under Property API Property Amenities.
Product APIDecember 10, 2020

Updated Eligibility for Hotel Loyalty Points value addition to Eligible for Hotel Loyalty Points.

Availability and Rates APIDecember 1, 2020

API now supports multiple, concurrent requests to update availability and rates on the same hotel.

Promotions capabilityNovember 2020

Released the initial version of the Lodging Partner GraphQL API to Expedia partners, including the promotions capability.

Property APINovember 19, 2020

Added SKI_STORAGE amenity code to Skiing and snow activities section of Enumerations.

Product APINovember 9, 2020
  • Added Wholesale Rate Plan to the list of Rate Plan types. Wholesale Rate Plan to be supported only during the GET and not during PUT,POST,PATCH or DELETE. The error code list is updated with 3232 error code which is returned when Create, Update or Delete of Wholesale Rate Plan is attempted.
  • Updated the Contact us link to direct additional questions.
  • Updated additionalGuestAmount resource to include missing percent.
Product APIOctober 30, 2020

Added fitness codes for Room Amenity:

  • These do not require detail codes: ROOM_TREADMILL, ROOM_STATIONARY_BIKE, ROOM_ROWING_MACHINE, ROOM_ELLIPTICAL_MACHINE
  • Use IN_ROOM or ON_REQUEST detail codes : ROOM_FREE_WEIGHTS, ROOM_STREAMING_FITNESS_CLASSES, ROOM_WORKOUT_APPAREL, ROOM_OTHER_WORKOUT_EQUIPMENT
Booking Notification APIOctober 7, 2020

Added 4202 error description.

Property APIOctober 7, 2020
  • Removed fax as notification channel. LCAM team reached out to partners regarding this change. This just needed partner documentation update.
  • Moved Breakfast DetailCodes, which need start and end time added to Policies section.
Booking Retrieval and Confirmation APIsSeptember 7, 2020

Added details on Changes to Expedia Collect (see blog from Sept. 7th, 2020 for more info).

Booking Notification APISeptember 3, 2020

Added details on Changes to Expedia Collect (see blog from Sept. 7th, 2020 for more info).

Property APIAugust 14, 2020

Changed POOL_CHILDRENS to CHILDRENS_POOL.

Property APIJuly 8, 2020

Deprecated NO_DATE_RANGE detailCode for CLOSURE_ONE and RENOVATION_ONE codes. Added PERCENTAGE_PER_STAY duration to be used with PERCENTAGE_PER_ACCOMMODATION scope for CLEANING_FEE code.

Product APIJuly 7, 2020

Updated ROOM_NO_HAIRDRYER to ROOM_NO_HAIR_DRYER.

Booking Notification APIJune 26, 2020

Added section for error codes that only appear in partner reports.

Booking Retrieval and Confirmation APIsJune 26, 2020

Added description for booking confirmation warning code 10105. Updated hotel collect example to reflect guest address is NOT actually sent.

Image APIJune 2020

Updated the categoryCodesEnum list with new Category Codes for Exterior Patio and Spa category groups.

Property APIJune 16, 2020

Added additional detail codes for FORMS_OF_PAYMENT_ACCEPTED code under Policy Section.

Property APIJune 15, 2020

Added additional Fee codes under Mandatory Fees section.

Property APIJune 10, 2020

Moved Fee codes with no values under Fee Inclusive / Excluded section. Made Fee Inclusive / Excluded a sub-section under Policies.

Property APIJune 2, 2020

Added Enhanced Cleaning and Traveler Safety codes under Policy Section.

Product APIMay 22, 2020
  • Updated the ROOM_COFFEE_TEA and ROOM_ELECTRONIC_DEVICE amenity codes to not support detailed codes anymore. Alternatively, each detail code has now been spun up as a different Amenity Code. Here are the new amenity codes: ROOM_COFFEE_AND_TEA_MAKER, ROOM_ESPRESSO_MAKER, ROOM_ELECTRIC_KETTLE, ROOM_COMPUTER, ROOM_TABLET, ROOM_IPAD.
  • Updated Expedia's requirements to certify Product API. Refer to the JSON Reference topic for more information.
Property APIMay 22, 2020

Added more detail to error messages returned during property status GET request on the Code Lists page.

Availability and Rates APIMay 20, 2020

Updated the maximum number of updates allowed in one message from 3000 to 5000.

Product APIApril 29, 2020

Added support for the No Room Size Amenity.

Property APIApril 29, 2020

Removed view_* amenity codes from Property API, as they are used in Product API. Added text to clarify values for SPA_TUB with detail code MULTIPLE.

Property APIApril 24, 2020

Made changes to ROOM_COFFEE_TEA_MAKER, ROOM_ESPRESSO_MAKER, ROOM_ELECTRIC_KETTLE, and THEME_SHOPPING_PROPERTY in the Appliances and other room features and Property theme sections.

Image APIApril 2020

Updated the categoryCodesEnum list with new Category Codes for Exterior, Room and Property Amenity groups.

Booking Notification APIApril 15, 2020

Updated the Expedia Virtual Card sample messages to indicate CVV details being sent (seriesCode field).

Property APIApril 7, 2020

Updated CUISINE_INDONESIAN typo in RESTAURANT_TWO, THREE, FOUR and FIVE in the Restaurant specifics section.

Product APIApril 2, 2020

Added support for 100+ new amenities spread across all categories: Internet access, Bathroom, Food-related, In-room entertainment, Bedding and linens, Room layout, In-room service, Room features, and Club/executive level. Added a new category for accessibility amenities inside guest accommodations.

Property APIApril 1, 2020

Removed SURCHARGE_AMT from Optional Fees section in Enumerations.

Property APIMarch 31, 2020

Made changes to DEPOSIT and PERCENTAGE_ DURATION in Mandatory Fees section of Enumerations.

Property APIMarch 26, 2020

Updated the Mandatory Fees section to remove Amount or Surcharge_Amount. Updated DATE attributes to retrieve the correct format of START_DATE and END_DATE. Updated new Image Subcategories for Accessibility, Room Facilities and Property Exterior sections in Enumerations.

Product APIFebruary 14, 2020

Added support for Regulatory Exemption Categories under regulatoryRecords for Room type actions.

Property APIJanuary 30, 2020

Removed Registrations section. isVacationRental is now the only field sent within Property API while the majority of regulatory information will be captured at the unit level within Product API under the regulatoryRecords section.

Product APIDecember 12, 2019

Updated Room type resource management to the V3 version, which includes bedroom and living room details. V2 versions moved over to the Archived section.

Property APIDecember 12, 2019

Added support of new "cash only" form of payment in Payment information section of Enumerations.

Booking Notification APIDecember 4, 2019

Updated the Expedia Virtual Card address to the new Expedia Group headquarters address.

Booking Retrieval and Confirmation APIsDecember 3, 2019

Updated the Cardholder address for Expedia Virtual Cards to the new Expedia Group headquarters address in all applicable sample messages.

Property APIDecember 2, 2019

Added additional self check-in instructions amenities under the Check-in, check-out, and front desk policies section in Enumerations.

Property APIOctober 30, 2019

Added additional activities including Adventure Activities, Safari, Sports Activities, Water Based Activities, and Skiing and Snowboarding.

Image APIAugust 2019

Updated the categoryCodesEnum list with structure type-neutral codes.

Property APIAugust 16, 2019

Added support of isVacationRental boolean within the API.

Booking Notification APIAugust 7, 2019
  • Launched Unicode support, which applies to China, Hong Kong, Japan, Korea, and Taiwan. Requires your systems to support UTF-8 encoding.
  • Added sample messages for bookings with Unicode characters in the <SpecialRequests> element and <PersonName>, <GivenName>, and <Surname> elements.
Availability and Rates APIAugust 7, 2019
  • Added sample message for bookings on Tax Inclusive properties.
  • Updated the documentation with details on bookings with Unicode characters.
Booking Retrieval and Confirmation APIsJuly 30, 2019

Launched Unicode support, which applies to China, Hong Kong, Japan, Korea, and Taiwan. Requires partner systems to support UTF-8 encoding. For additional details see Unicode Support.

Property APIJuly 3, 2019

Added support of Hide Address and Hide Exact location capabilities.

Property APIJune 21, 2019

Added additional content in Enumerations including: additional amenities, activities, property themes, and negative amenities.

Product APIJune 7, 2019

Released new feature to expose <allowedAgeCategories> for Property level GET. Added documentation references in Sample Messages and Reference.

Booking Notification APIDecember 18, 2018

Added sample message for email alias.

Booking Retrieval and Confirmation APIsDecember 18, 2018

Added sample message for email alias.

Booking Notification APIDecember 10, 2018

Updated Sample BR Responses with a No Credit Card booking example.

Booking Retrieval and Confirmation APIsDecember 10, 2018

Updated Sample BR Responses with a No Credit Card booking example.

Property APINovember 19, 2018

Added support of Breakage Deposits in the Enumerations.

Property APIAugust 20, 2018

Updated the Enumerations page to have all the Amenity, Attribute, Policy, Image Category codes called out.

Booking Notification APIJune 29, 2018
  • Added new supported credit card types: Union Pay and Carte Blanche.
  • Added TLS 1.2 requirement.
Booking Retrieval and Confirmation APIsJune 29, 2018
  • Added new supported credit card types: Union Pay and Carte Blanche.
  • Added TLS 1.2 requirement.
Product APIJune 15, 2018

Added support documentation about Per Stay Service Fees at the Rate plan level (GET, POST, PUT).

Property APIMay 18, 2018

Added Languages Spoken to the Enumerations for Amenities.

Property APIMay 15, 2018

Added ContractTermsChanging and CurrencyCodeChanging to PendingReview Reason Codes.

Property APIApril 25, 2018

Added support for Number of Bedrooms, Number of Bathrooms, Occupancy under Enumerations - Policies.

Property APIApril 20, 2018

Added support for the Read/Update by ExpediaID use case.

Property APINovember 10, 2017

Added support Decentralized Billing and sample onboarding request to the documentation.

Booking Notification APIOctober 31, 2017

Added HTTP header information.

Deposit APIAugust 2017

Launched the Deposit API v1.

Product APIAugust 7, 2017
  • Added information about managing deposit required flag in conjunction with Deposit API.
  • Added documentation about new <depositPolicy> link in Rate Plan's links section of the response payload on GET Rate Plan and GET Rate Plans operations.
Product APIJuly 31,2017

Added access to room type and rate plan resources without "/products" in endpoint path.

Product APIMay 19, 2017

Corrected list of support room views.

Booking Notification APIApril 11, 2017

Added new point of sale brands: American Express Travel, Amex The Hotel Collection, and Amex FINE HOTELS AND RESORTS.

Booking Notification APIMarch 31, 2017

Added new point of sale brands: Travelocity, Orbitz, Wotif, and other Expedia Group, Inc. brands.

Availability and Rates APINovember 21, 2016

Removed Simulator Documentation as this feature was deprecated.

Product APINovember 12, 2016

Released new feature to expose a rate plan's deposit required flag, create, and last update dates in read-only format. These attributes can be read via GET. They cannot be provided with a create request (deposit is set to false by default), and they cannot be changed in update requests.

Product APIOctober 20, 2016

Released a new feature to expose a room type's rate thresholds, in read-only format. Only GET operation is allowed on this sub resource.

Product APIOctober 18, 2016

Released a new feature to expose RatePlanLinkage information in read-only format in rate plan GET. Added a links section to the show rate plan resource's link to itself, its rate plan linkage parent, if any, and/or its derived child rate plans, if any.

Product APISeptember 29, 2016

Added new section documenting changes between V1 and V2 to the documentation.

Image APISeptember 2016

The API now supports updates to existing images’ metadata via PATCH verb. The PATCH modify operation is a way for you to send a request containing only the data you would like to modify about the image, as opposed to the entire data about the resource. From your perspective, the PATCH feature allows for modification of the image resource without having to pre-load the entire data about the resource.

Expedia Group implemented the Merge-PATCH strategy for Image API. You can send any of the top-level elements you'd like to modify, and omit the ones you do not want to change. Expedia Group will take care of merging the resource updates and preserve what was not included in your PATCH request.

For complete information, refer to PATCH feature.

Image APISeptember 2016

Renamed guide by resourceID.

Image APIAugust 2016

Clarified categories and added examples to documentation.

Image APIAugust 2016

Release Image API v1.

Product APIJune 10, 2016

Released Product API v2. Versioning strategy changed from URL to using content-type and accept headers. As a result, URLs have all changed to have V1 removed when you are ready to use V2. Room type resource changed significantly for defining bed types and occupancy.

Booking Notification APIMay 15, 2016

Released the initial version of the API.

Availability and Rates APIMay 15, 2016

Released the initial version of the API.

Product APIMay 2, 2016

Added support for cancel policy exceptions.

Product APIApril 27, 2016

Added support for Rate Plan Delete.

Product APIApril 4, 2016

Refreshed list of supported value adds, added more pricing models supported, clarified required VS optional fields.

Product APIFebruary 1, 2016

Added support for room-level amenities (GET and PUT).

Product APIJanuary 7, 2016

Support for read/create/update room views and wheelchair accessibility in room type resource.

Product APIDecember 7, 2015

Released the first version of the API. Additional feature since last PDF version: support for read/create/update room size in room type resource.