Revision history
The following updates have been made to the reservation management capability of the Lodging Supply GraphQL API schema, from newest to oldest updates:
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 enhancements to reservation retrieval:
supplierAmounthas been replace by theamountsobject onReservation;amountsreturns comprehensive, detailed reservation amount valuespaymentInstructionshas been replaced by thepayment : instructionsobject on theReservationsobjectpayment : instrumentandpayment : installmentsis now available on theReservationobject to retrieve credit card, EVC, and payment informationcancellationPolicyobject was added to theReservationobject to retrieve the cancellation policy that was in place when the reservation was made
payment : installmentsobject was added to theReservationobject so you can retrieve the payment schedule used to collect payment for the reservationremittanceTypeobject was added to theReservationobject to indicate the remittance type used for a reservationsupplierOperatingModelwas added to theReservationobject to indicate the operation model of the lodging partneraffiliateSourceandinvoicingfields added, to support corporate travelersitineraryReferencefield was added to theReservationAlternativeIdsobject to enable partners to pass itinerary IDs to travelersIntroduced enhancements to reservation update:
- Added the
reasoninput argument to thechangeReservationReconciliationmutation - Added the
refundReservationmutation to enable partners to refund a reservation's rate on or after a reservation’s check-in date
- Added the
Introduced reservation delivery, which includes
- A new webhook notification (
ReservationNotificationEventevent type) - The
confirmReservationNotificationmutation
- A new webhook notification (
November 2024
- Added the
clientMutationIdfield to all mutation input and payload objects. - Added the
companyNamefield to theGuestobject, to enable partners to retrieve the company a guest works for.
October 2024
Type changed from Int to String for SupplierLoyaltyPlanInfo : membershipNumber.
August 2024
Deprecated the paymentInstructions field on the Reservation object. Use payment : instructions instead.
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.
October 2023
The following types have been added or updated to bring the API into parity with EPC:
Guest : phoneNumbersSupplierLoyaltyPlanInfo : planCodeSupplierLoyaltyPlanInfo : membershipNumberReservation : childAgesReservation : tidsCodeGuest : emailAddress
In addition, these fields have been deprecated:
Reservation : loyaltyTier(loyaltyTieris now in theGuestobject)Reservation : guestContact(replaced byprimaryGuest)
For more information, refer to the reservations query.
March 2023
Added the guestContact object, reconciliationType field, and isReconciled field to the reservations query.
December 2022
Added the reservation update feature to the reservation management capability, which added the cancelReservationReconciliation and changeReservationReconciliation mutations.
November 2022
- Added the
lastUpdatedDateTimefilter to the reservations query, enabling partners to backload reservation data for reservation events that were impacted by a delivery connection outage. - Added the
loyaltyTierfield to theReservationobject to enable partners to retrieve guest loyalty tier. - Added the
accessibilityTextfield to theReservationobject to enable partners to retrieve accessibility requests made by the guest for the reservation. - Added the
valueAddedPromotionsfield to theReservationobject, enabling partners to retrieve value add promotions (VAP) used to book the reservation. - Removed
checkInTime,checkOutTime,petCount, andpaymentSchedulefrom theReservationobject. - Removed emailAddress
andphoneNumberfrom theGuest` object.
October 2022
Updated endpoints:
- Token service, from
https://apis.expediaconnectivity.com/oauth/tokentohttps://api.expediagroup.com/identity/oauth2/v3/token - API endpoint, from
https://apis.expediaconnectivity.com/graphqltohttps://api.expediagroup.com/supply/lodging/graphql
Schema changes:
Property : geoLocationis deprecated and replaced withcoordinatesAddress : cityis deprecated and replaced withlocalityAddress : countryis deprecated and replaced withcountryCodeAddress : line1, line2, line3are deprecated and replaced withaddressLinesAddress : provinceis deprecated and replaced withadministrativeAreasublocalityfield added to theAddressobject
February 2022
Added the reservation ID filter to the reservations query, enabling partners to query for reservations based on ID.
October 2021
Added reconciliationEligibility to the Reservation type to enable partners to determine whether a reservation can be reconciled (using the reservation reconciliation capability).
May 2021
Released the initial version of the reservation retrieval feature of the reservation management capability of the Lodging Partner GraphQL API.