Recent changesAPI change log

March 2026

Added credit card validation and recapture functionality to the capability. To support this, the following were added:

paymentInstrumentDetails and cancellationEligibility objects were added to the Reservation object, which is included in the payload of the reservation and reservations queries
markGuestCreditCardAsInvalid mutation was added to enable partners to report a card as invalid from their connected system

March 2026

simulatePaymentValidationFlow mutation was added to support testing of credit card validation and recapture. It enables you to emulate a guest response and simulate the payment instrument validation flow.

February 2026

Updated the list of allowed values for valueAdds, in the CreateRatePlanInput and UpdateRatePlanInput objects.

January 2026

Added the cancellationPolicyConfig query to the documentation.

January 2026

The following value add inclusions (valueAddInclusionsEnum) were added for standalone and package rate plans:

Bottle of wine per stay
Brunch
Dinner for 2
Dinner per stay
Fruit basket per stay
Holiday brunch
Meals for children included
Non-alcoholic all-inclusive (food/soft beverages/snacks)
Weekend brunch
Club or executive lounge access
Boat transfer included
Floatplane transfer included
One-way airport shuttle (pickup)
One-way airport shuttle (drop off)
Laundry service (limited items)
Laundry discount
Laundry credit
Non-motorized water sports included
Hot springs access
Amusement park passes
Spa discount (select services)

The following value add inclusions (valueAddInclusionsEnum) were added for corporate rate plans:

Afternoon tea
Airport transfer (drop off service)
Airport transfer (pickup service)
Roundtrip airport transfer
All-inclusive (food/beverages/snacks)
Breakfast Included
All meals
Casino credit
Casino match play
Casino slot play
Coffee/pastries each morning
Buffet dinner
Drinks and hors d'oeuvres
Dry cleaning
Food and beverage credit
Full board
Welcome gift
Half board (breakfast and dinner)
Laundry item per day
Lunch included
Massage included
Extended parking
Spa access
Spa credit

January 2026

The following mandatory fees have been removed:

FIREWOOD_FEE
POOL_FEE
POOL_HEATING_FEE
SPA_FEE
SPA_TUB_FEE
TOWELS_FEE

January 2026

The reservation query was added.
In amounts:summary and amounts:nightlyPayments:perStayAmounts, a WITHHOLDING_TAX line item may now be reported. This shows taxes that are withheld and directly paid by Expedia in accordance with the jurisdiction's tax regulations

December 2025

Removed the following Value Add Inclusions (valueAddInclusionsEnum) for corporate rate plans:

Free Local Calls
Includes One Free In-Room Movie
Free Train Shuttle
In-Room Dinner
Evening Manager's Reception

November 2025

Expedia Virtual Card (EVC) has been renamed to "virtual card" to improve partner recognition and reduce escalations and poor customer experience.

November 2025

Expedia Virtual Card (EVC) has been renamed to "virtual card" to improve partner recognition and reduce escalations and poor customer experience.

November 2025

Updated the list of allowed values for valueAdds, in the CreateRatePlanInput and UpdateRatePlanInput objects.

November 2025

Added the following Value Add Inclusions (valueAddInclusionsEnum):

Breakfast for up to 2 adults
Half board (breakfast and dinner)
Half board (breakfast and lunch)
Ramadan meal (suhoor)
Ramadan meal (iftar)

November 2025

Expedia Virtual Card (EVC) has been renamed to "virtual card" to improve partner recognition and reduce escalations and poor customer experience.

October 2025

Added rate plan linkage to the product management capability (available in the createRatePlan mutation, updateRatePlan mutation, ratePlan query, and ratePlans query).
Added the ability to define non-refundable stay dates when creating or updating cancellation policies.
Added the localTaxJurisdiction query and setUnitLegalNumberOfNewYorkRoomsRegulatoryAttributes mutation, to manage tax settings for properties in New York City.

October 2025

Added the AFFITTACAMERE structure type.
Removed Covid-related enumerations: ENHANCED_CLEANING_PRACTICES, NO_ENHANCED_CLEANING, PROFESSIONALLY_CLEANED, NO_PROFESSIONALLY_CLEANED, CLEANING_DISINFECTION, NO_CLEANING_DISINFECTION, COMMON_SURFACE_DISINFECTANT_CLEANED, NO_COMMON_SURFACE_DISINFECTANT_CLEANED, LINENS_HIGH_TEMP_WASH, NO_LINENS_HIGH_TEMP_WASH, REGION_SANITIZATION_CERTIFIED : OAKWOOD_CLEAN_360, REGION_SANITIZATION_CERTIFIED : BELMOND_PROTECTS, NO_REGION_SANITIZATION_CERTIFIED, COVID_TEST_RESERVATION, CLEAN_SANITATION_GUIDE_IWBI, CLEAN_SANITATION_GUIDE_CDC, CLEAN_SANITATION_GUIDE_GBAC, CLEAN_SANITATION_GUIDE_COVID_CLEAN, CLEAN_SANITATION_GUIDE_WHO, ASSOCIATION_SANITARY_SAFESTAY, ASSOCIATION_SANITARY_DTV_DFV, ASSOCIATION_SANITARY_CRISTAL, ASSOCIATION_SANITARY_SAFETRAVELS, ASSOCIATION_SANITARY_HUT, NO_ASSOCIATION_SANITARY, HAS_GUEST_SAFETY_MEASURES, NO_GUEST_SAFETY_MEASURES, GUEST_PROTECTIVE_CLOTHES, NO_GUEST_PROTECTIVE_CLOTHES, GUEST_PROTECTION_MASKS, GUEST_PROTECTION_GLOVES, STAFF_PROTECTIVE_CLOTHES, NO_STAFF_PROTECTIVE_CLOTHES, SHIELD_IN_MAIN_AREAS, NO_SHIELD_IN_MAIN_AREAS, HAND_SANITIZER_PROVIDED, NO_HAND_SANITIZER_PROVIDED, SOCIAL_DISTANCING, NO_SOCIAL_DISTANCING, WRAPPED_FOOD, WRAPPED_FOOD_BREAKFAST, WRAPPED_FOOD_LUNCH, WRAPPED_FOOD_DINNER, WRAPPED_FOOD_ROOM_SERVICE, WRAPPED_FOOD_NO, WAITING_PERIOD_48_HOURS, WAITING_PERIOD_72_HOURS, TEMP_CHECKS_STAFF, NO_TEMP_CHECKS_STAFF, TEMP_CHECKS_GUESTS, NO_TEMP_CHECKS_GUESTS, SEALED_AFTER_CLEANING, NO_SEALED_AFTER_CLEANING, GUEST_PROTECTION_MASKS_REQUIRED, NO_GUEST_PROTECTION_MASKS_REQUIRED, CONTACTLESS_FOOD, NO_CONTACTLESS_FOOD, FOOD_SERVICE_AMENDED, NO_FOOD_SERVICE_AMENDED, FACILITY_RESERVE_REQUEST, NO_FACILITY_RESERVE_REQUEST, ELECTROSTATIC_SPRAY, NO_ELECTROSTATIC_SPRAY, ASSOCIATION_SANITARY_BUREAU_VERITAS, ASSOCIATION_SANITARY_ECOLAB, ASSOCIATION_SANITARY_FHRAI, ASSOCIATION_SANITARY_SGS, ASSOCIATION_SANITARY_SAFE_CLEAN_LEGAL, ASSOCIATION_SANITARY_NEW_NORMAL

September 2025

Due to high levels of spam and phishing we have limited the file types supported by the attachment service. Now, only JPEG, PDF, and PNG are supported.

September 2025

Currency code is no longer required when defining a cancellation penalty rule (when defining tiers in default policies or policy overrides). To make this change, the flatAmount field on the CancellationPenaltyRuleInput input object is now of type MoneyWithDefaultableCurrencyInput instead of MoneyInput.

September 2025

Removed the following Value Add Inclusions enumerations: Incl. 500 CP Reward Pts., Incl. 1000 CP Reward Pts., Incl. 4000 CP Reward Pts., and Incl. 5000 CP Reward Pts.
Changed the Early Check-in enumeration to "Early check-in (subject to availability)"
Changed the Late Check-out enumeration to "Late check-out (subject to availability)"
Changed the Free Room Upgrade enumeration to "Free room upgrade (subject to availability)"
Changed the Food/Beverage Credit enumeration to "Food/Beverage Credit or Discount"
Removed VIP Line Access to Nightclub(s), Free Ski Lift Ticket & Rental, and Taiwanese-style breakfast
Changed the Free Airport Parking enumeration to "Extended Parking"

August 2025

The cancellationPolicyConfigs field under the Policies object (and policies query) will be replaced by cancellationPolicyConfigsPaginated, to provide filters and paginated results when retrieving a property's cancellation policies. The cancellationPolicyConfigs field will be fully deprecated and unsupported in Q4 2025.

Old query:

query {
  property(id: $id, idSource: $idSource) {
    id 
    policies {
      cancellationPolicyConfigs {
        id
        name
        ...
      }
    }
  }
}

New query:

query {
  property(id: $id, idSource: $idSource) {
    id 
    policies {
      cancellationPolicyConfigsPaginated(limit: $limit, cursor: $cursor) {
        totalCount
        cursor
        elements {
          id
          name
          ...
        }
      }
    }
  }
}

Deprecated the size and type fields within the BedType, BedTypeInput, and BedTypeMetadata objects, and introduced the new sizeV2 and typeV2 fields. (These fields are used when defining bed groups in units and unit spaces.) The size and type fields will be fully deprecated and unsupported in Q4 2025.
The supported values for the new fields are as follows:
- Bed sizes:
  - For conventional lodging, allowed values include FULL, KING, QUEEN, TWIN, and TWIN_XL.
  - For vacation rentals, allowed values include CHILD, CRIB, TWIN, FULL, QUEEN, KING, and TWIN.
- Bed types:
  - For conventional lodging, allowed values include BUNK_BED, FULL_BED, FUTON, KING_BED, MURPHY_BED, QUEEN_BED, SOFA_BED, TRUNDLE_BED, TWIN_BED, TWIN_XL_BED, and WATER_BED.
  - For vacation rentals, allowed values include BUNK_BED, CHILD_BED, CRIB_FIXED, FULL_BED, FUTON, KING_BED, MURPHY_BED, QUEEN_BED, SOFA_BED, and TWIN_BED.

August 2025

Added the following values to the Value Add Inclusions enumeration:

Afternoon tea
Extended parking - 4 days of parking
Extended parking - 7 days of parking
Extended parking - 10 days of parking
Extended parking - 14 days of parking

August 2025

Updated the enumerations list with add AFTERNOON_TEA under Breakfast details and dining (general).

August 2025

cancelReservation mutation has been replaced by the updateReservationCancellation mutation.

July 2025

New file types are now supported by the attachment service. Refer to its reference page for the list.

June 2025

Added the taxId field to the BankIssuedCard object in the schema.

June 2025

SMOKING_AND_NON_SMOKING is no longer supported as an enum for a units' smoking policy (smokingPolicy).

June 2025

Match Play has been removed from the list of supported value-add inclusions for standalone and package rate plans.
When defining a room type resource, Smoking and Non-Smoking can no longer be specified together for smokingPreferences. Only one preference can be specified.

May 2025

The registration query is nested under the units object of the property query; the units object will be replaced with the unitsPaginated object. Stated differently, the units query will be replaced by the unitsPaginated query, to provide filters and paginated results when retrieving a property's units. The units object will be fully deprecated and unsupported in Q4 2025.

Note that the units query retrieves active and inactive units. unitsPaginated returns only active units, by default. To retrieve active and inactive units using unitsPaginated, you must include the status filter (set to state: ALL).

Old query:

query {
  property(id: $id, idSource: $idSource) {
    units {
      registration: Registration
      ...
    }
  }
 }

New query:

query {
  property(id: $id, idSource: $idSource) {
    unitsPaginated(
      cursor: $cursor, 
      filters: {
        status: {state: ALL}
      },
      limit: $limit
    ) {
      elements {
        registration: Registration
        ...
      }
    }
  }
}

May 2025

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

May 2025

Added the issuerCode field to the BankIssuedCard object in the schema.

May 2025

The units query will be replaced by the unitsPaginated query, to provide filters and paginated results when retrieving a property's units. Stated differently, the units object under the property query will be replaced with the unitsPaginated object. The units query will be fully deprecated and unsupported in Q4 2025.
Note that the units query retrieves active and inactive units. The unitsPaginated query returns only active units, by default. To retrieve active and inactive units using the unitsPaginated query, you must include the status filter (set to state: ALL).
Old query:
```
query {
  property(id: $id, idSource: $idSource) {
    units {
      ids {
        id
        idSource
      }
      activeStatus {
        active
      }
      ...
    }
  }
}
```
New query:
```
query {
  property(id: $id, idSource: $idSource) {
    unitsPaginated(
      cursor: $cursor, 
      filters: {status: {state: $status}},
      limit: $limit
    ) {
      elements {
        ids {
          id
          idSource
        }
        ...
      }
    }
  }
}
```
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 - 3-20 characters are supported

May 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 - 3-20 characters are supported

May 2025

Previously, reservations could be reconciled using the cancelReservationReconciliation or changeReservationReconciliation mutation on or after the check-in date. Now, reservations can be reconciled from the day after check-in at 5am until the fourth day of the month after the checkout date.

April 2025

Released the initial version of the Payments API.

April 2025

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

April 2025

Structure type definitions added.
Removed GUEST_GAP_PERIOD and NO_GAP_PERIOD_BETWEEN_GUESTS from the Enhanced cleaning and traveler safety enumerations.

April 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, virtual card, 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
- A new webhook notification (ReservationNotificationEvent event type)
- The confirmReservationNotification mutation

April 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
Released the initial version of the Sandbox API.

March 2025

Added the Japanese-style value to the roomClassEnum enumeration.

February 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.

January 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

November 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.

November 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.

November 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).

November 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.

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.

October 2024

Type changed from Int to String for SupplierLoyaltyPlanInfo : membershipNumber.

September 2024

Removed support for GIF attachment types.

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).

August 2024

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

July 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.

July 2024

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

June 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.

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.

June 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.

April 2024

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

March 2024

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

February 2024

Property status notifications added.

January 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.

December 2023

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

November 28, 2023

Updated the enumerations list with new tattoo restrictions.

November 2023

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

October 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.

August 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.

June 2023

Released the initial version of the notifications capability.

June 2023

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

March 24, 2023

Updating PET_POLICY notes to reflect the legal guidelines.

March 2023

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

March 15, 2023

Updated the enumerations list to include accessibility attributes.

March 04, 2023

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

January 2023

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

December 2022

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

November 2022

Released the initial version of the compliance capability.

November 2022

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

November 2022

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

November 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.

November 03, 2022

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

Oct 2022

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

October 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

October 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

August 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.

April 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"

February 2022

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

November 2021

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

November 2021

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

October 2021

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

October 2021

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

September 2021

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

September 14, 2021

Added enumerations to support bulk media scraping.

August 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.

July 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.)

June 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%.

May 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.

May 2021

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

April 20, 2021

Added MOBILE_HOME to the Enumeration list of supported structure type.

March 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.

March 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)

March 18, 2021

Added additional amenities under Enhanced Cleaning and Traveler Safety.

March 05, 2021

Added warning codes under Error handling section.

February 8, 2021

Updated support of custom cancellation policy.

January 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.

December 10, 2020

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

December 1, 2020

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

November 2020

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

November 19, 2020

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

November 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.

October 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

October 7, 2020

Added 4202 error description.

October 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.

September 7, 2020

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

September 3, 2020

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

August 14, 2020

Changed POOL_CHILDRENS to CHILDRENS_POOL.

July 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.

July 7, 2020

Updated ROOM_NO_HAIRDRYER to ROOM_NO_HAIR_DRYER.

June 26, 2020

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

June 26, 2020

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

June 2020

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

June 16, 2020

Added additional detail codes for FORMS_OF_PAYMENT_ACCEPTED code under Policy Section.

June 15, 2020

Added additional Fee codes under Mandatory Fees section.

June 10, 2020

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

June 2, 2020

Added Enhanced Cleaning and Traveler Safety codes under Policy Section.

May 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.

May 22, 2020

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

May 20, 2020

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

April 29, 2020

Added support for the No Room Size Amenity.

April 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.

April 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.

April 2020

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

April 15, 2020

Updated the virtual card sample messages to indicate CVV details being sent (seriesCode field).

April 7, 2020

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

April 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.

April 1, 2020

Removed SURCHARGE_AMT from Optional Fees section in Enumerations.

March 31, 2020

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

March 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.

February 14, 2020

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

January 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.

December 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.

December 12, 2019

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

December 4, 2019

Updated the virtual card address to the new Expedia Group headquarters address.

December 3, 2019

Updated the cardholder address for virtual cards to the new Expedia Group headquarters address in all applicable sample messages.

December 2, 2019

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

October 30, 2019

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

August 2019

Updated the categoryCodesEnum list with structure type-neutral codes.

August 16, 2019

Added support of isVacationRental boolean within the API.

August 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.

August 7, 2019

Added sample message for bookings on Tax Inclusive properties.
Updated the documentation with details on bookings with Unicode characters.

July 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.

July 3, 2019

Added support of Hide Address and Hide Exact location capabilities.

June 21, 2019

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

June 7, 2019

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

December 18, 2018

Added sample message for email alias.

December 18, 2018

Added sample message for email alias.

December 10, 2018

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

December 10, 2018

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

November 19, 2018

Added support of Breakage Deposits in the Enumerations.

August 20, 2018

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

June 29, 2018

Added new supported credit card types: Union Pay and Carte Blanche.
Added TLS 1.2 requirement.

June 29, 2018

Added new supported credit card types: Union Pay and Carte Blanche.
Added TLS 1.2 requirement.

June 15, 2018

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

May 18, 2018

Added Languages Spoken to the Enumerations for Amenities.

May 15, 2018

Added ContractTermsChanging and CurrencyCodeChanging to PendingReview Reason Codes.

April 25, 2018

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

April 20, 2018

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

November 10, 2017

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

October 31, 2017

Added HTTP header information.

August 2017

Launched the Deposit API v1.

August 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.

July 31,2017

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

May 19, 2017

Corrected list of support room views.

April 11, 2017

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

March 31, 2017

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

November 21, 2016

Removed Simulator Documentation as this feature was deprecated.

November 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.

October 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.

October 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.

September 29, 2016

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

September 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.

September 2016

Renamed guide by resourceID.

August 2016

Clarified categories and added examples to documentation.

August 2016

Release Image API v1.

June 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.

May 15, 2016

Released the initial version of the API.

May 15, 2016

Released the initial version of the API.

May 2, 2016

Added support for cancel policy exceptions.

April 27, 2016

Added support for Rate Plan Delete.

April 4, 2016

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

February 1, 2016

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

January 7, 2016

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

December 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.

Availability and rates APIs

Booking APIs

Property mgmt APIs

Developer Tools