Revision historyCopy link

The following updates have been made to the reservation management capability of the Lodging Supply GraphQL API schema, from newest to oldest updates:

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, 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

• 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

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

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

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

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

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.