Documentation

MutationsSandbox Data Mgmt API

updateReservation mutation

Modifies a reservation in the sandbox environment. This mutation is especially helpful in testing soft modifications, hard modifications, and cancelled reservations.

To receive a CANCELLED webhook notification, status: CANCELLED must be specified in the input.
To receive a MODIFIED notification, update any of the fields supported by updateReservation.

Syntax

1mutation {
2  updateReservation(input: UpdateReservationInput!): UpdateReservationPayload!     
3}

Example

This example updates a reservation to include a new check-in and checkout date.

Request
Response

1mutation { 
2  updateReservation(input: { 
3    checkInDate: "2024-04-01", 
4    checkOutDate: "2024-04-05", 
5    id: "100000012", 
6    sendNotification: true 
7    }) { 
8    reservation { 
9      id 
10      accessibilityText 
11      adultCount 
12      childCount 
13      childAges 
14      smokingType 
15      source 
16      status 
17      checkInDate 
18      checkOutDate 
19      creationDateTime 
20      lastUpdatedDateTime 
21    } 
22  } 
23}

Arguments

Name	Description
`input`	Required. Type: UpdateReservationInput

Types

Name

Type

Boolean

The Boolean scalar type represents true or false.

BusinessModel

Enum

Entity that collects payment for the reservation.

Name	Description
`EXPEDIA_COLLECT`	Expedia collects payment for the reservation.
`HOTEL_COLLECT`	Partner collects payment for the reservation.

Date

Scalar that represents a date string compliant with the RFC 3339 profile of the ISO 8601 standard.

Float

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Guest

Object

Details about the guest who made the reservation.

Field	Description
`emailAddress`	Not nullable. Email address of the guest. Type: String
`firstName`	Not nullable. First (given) name of the guest. Type: String
`lastName`	Not nullable. Last name (surname) of the guest. Type: String
`loyaltyTier`	Not nullable. The traveler's Expedia Group VIP Access loyalty tier. Values include MEMBER, VIP, PREMIUMVIP, and null. Type: String
`phoneNumbers`	Not nullable. Phone numbers associated with the guest. Type: Array of non nullable GuestContactPhoneNumber
`supplierLoyaltyPlanInfo`	Details about the guest's frequent traveler reward program. Type: SupplierLoyaltyPlanInfo

GuestContactPhoneNumber

Object

Guest phone number.

Field	Description
`areaCode`	Not nullable. Area code (three digits). Type: String
`countryCode`	Not nullable. Country code (two digits). Type: String
`number`	Not nullable. Phone number (seven digits, no hyphen). Type: String

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

IdNode

Object

Known IDs in the source system.

Field	Description
`id`	Not nullable. ID in the source system. Type: String
`idSource`	Not nullable. Source of the ID. Type: IdSource

IdSource

Enum

Source of a given ID.

Name	Description
`EXPEDIA`	Expedia is the source of the ID.
`SUPPLIER`	Connectivity provider or lodging partner is the source of the ID.
`VRBO`	Unsupported.

Int

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Money

Object

Monetary amount along with its currency.

Field	Description
`amount`	Not nullable. Actual monetary amount value. The scale of the amount will vary according to the currency or any rate conversion that may have been applied. Type: String
`currencyCode`	Not nullable. Code of the currency of the amount. Type: String

Payment

Object

Guest payment details.

Field	Description
`cardNumber`	Not nullable. Card number. For Expedia Collect reservations, the sandbox value is randomly generated but always begins with `5`. For Hotel Collect reservations, the card number is randomly generated. Type: String
`issuerName`	Not nullable. Name of the issuer associated with the card. For Expedia Collect reservations, the issuer name is \"MasterCard\". For Hotel Collect reservations, the issuer name is randomly generated. Type: String
`paymentInstrumentType`	Not nullable. Type of payment instrument. Sandbox value is \"GUEST_CREDIT_CARD\" for HOTEL_COLLECT reservations and \"EXPEDIA_VIRTUAL_CARD\" for EXPEDIA_COLLECT reservations. Type: String
`verificationNumber`	Randomly generated, three-digit verification number associated with the card. Type: String

ReconciliationType

Enum

Type of reconciliation that has been performed on the reservation.

Name	Description
`CANCEL`	Reservation was cancelled.
`MODIFY`	Reservation was modified.
`NO_SHOW`	Reservation was marked as a no-show.
`REFUND`	Reservation was refunded.

RemittanceType

Enum

Remittance type of the reservation.

Name	Description
`GROSS`	Gross remittance type.
`NET`	Net remittance type.

Reservation

Object

Reservation details.

Field	Description
`accessibilityText`	Not nullable. Accessibility requests made by the guest for the reservation. Type: Array of non nullable String
`adultCount`	Not nullable. Count for all adult guests associated with the reservation. Type: Int
`amounts`	Amounts associated with the reservation. Type: ReservationAmounts
`bedTypes`	Bed type of the reservation. Type: String
`businessModel`	Not nullable. Entity that collects payment for the reservation. Type: BusinessModel
`checkInDate`	Not nullable. Check-in date (format: YYYY-MM-DD) of the reservation. Type: Date
`checkOutDate`	Not nullable. Checkout date (format: YYYY-MM-DD) of the reservation. Type: Date
`childAges`	Ages of children associated with the reservation. Type: Array of non nullable Int
`childCount`	Not nullable. Count for all child guests associated with the reservation. Type: Int
`creationDateTime`	Not nullable. Date amd time when the reservation was created (format: yyyy-MM-dd'T'HH:mm:ss.SSSX, in UTC timezone). Type: String
`id`	Not nullable. Expedia ID of the reservation. Type: ID
`isReconciled`	Not nullable. Whether the reservation has been reconciled. Type: Boolean
`lastUpdatedDateTime`	Not nullable. Date and time when the reservation was last updated (format: yyyy-MM-dd'T'HH:mm:ss.SSSX, in UTC timezone). Type: String
`multiRoomText`	Text that is displayed to guests if there is a multi-room booking associated with the reservation. Type: String
`payment`	Not nullable. Payment details associated with the reservation. Type: Payment
`petCount`	Count of pets associated with the reservation. Type: Int
`primaryGuest`	Not nullable. Guest who made the reservation. Type: Guest
`propertyId`	Not nullable. Expedia ID for the property. Type: ID
`rateIds`	Unique identifiers for the rates associated with the reservation. Type: Array of non nullable IdNode
`reconciliationType`	Type of reconciliation that has been performed on the reservation, if any. Type: ReconciliationType
`remittanceType`	Remittance type of the reservation. Defaults to null. Type: RemittanceType
`reservationIds`	Not nullable. IDs for the reservation(s), each corresponding to a different source associated with the reservation. Type: Array of non nullable IdNode
`smokingType`	Not nullable. Whether smoking is allowed for the reservation. Type: String
`source`	Not nullable. Source of the reservation. Type: String
`specialRequest`	Text that is displayed to guests if there is a special request associated with the reservation. Type: String
`status`	Not nullable. Current status of the reservation. Type: ReservationStatus
`supplierOperatingModel`	Supplier's operating model. Type: SupplierOperatingModelType
`tidsCode`	Travel Industry Designator Service (TIDS) code that allows a reservation to be recognized by industry suppliers. Type: Int
`totalGuestCount`	Not nullable. Number of guests associated with the reservation. Type: Int
`unitIds`	Known IDs for the unit/room in the source system(s). IDs that are returned depend on where the property was onboarded: If the property was onboarded onto Vrbo, three IDs are returned: the partner's (external ID), Vrbo's (Vrbo internal ID), and Expedia's (EID). If the property was onboarded onto Expedia, only the Expedia ID is included in the response. Type: Array of non nullable IdNode
`valueAddedPromotions`	Value add promotion(s) used to book the reservation. Type: Array of non nullable ReservationValueAddedPromotion

ReservationAmounts

Object

Amounts associated with the reservation.

Field	Description
`nightlyPayments`	Detailed list of payments associated with the reservation. Type: ReservationNightlyPayments

ReservationDailyAmount

Object

Reservation amount that applies to a specific stay date.

Field	Description
`amount`	Not nullable. Amount value. Type: Money
`date`	Not nullable. Amount date (format: yyyy-MM-dd), such as 2025-01-30. Type: Date
`description`	Not nullable. Description associated to the amount. Type: String
`percent`	Percentage of amount (when applicable), expressed as a fraction of 1 (such as 0.12 for 12%). Type: Float
`type`	Not nullable. Amount type (BASE, DISCOUNT, TAX, GUESS_PAYMENT, PAYOUT, and so on). Type: String

ReservationNightlyPayments

Object

Nightly payments associated with the reservation.

Field	Description
`cancellationAmounts`	Not nullable. Cancellation amounts for the reservation. Type: Array of non nullable ReservationPerStayAmount
`dailyAmounts`	Not nullable. Reservation amounts for a specific stay date. Type: Array of non nullable ReservationDailyAmount
`perStayAmounts`	Not nullable. Reservation amounts that apply to the whole stay. Type: Array of non nullable ReservationPerStayAmount

ReservationPerStayAmount

Object

Reservation amount that applies to the whole stay.

Field	Description
`amount`	Not nullable. Amount value. Type: Money
`description`	Not nullable. Description associated to the amount. Type: String
`percent`	Percentage of amount (when applicable), expressed as a fraction of 1 (such as 0.12 for 12%). Type: Float
`type`	Not nullable. Amount type (BASE, DISCOUNT, TAX, GUESS_PAYMENT, PAYOUT, and so on). Type: String

ReservationStatus

Enum

Current status of the reservation.

Name	Description
`BOOKED`	Reservation is booked and confirmed.
`CANCELLED`	Reservation is cancelled.

ReservationStatusInput

Enum

Current status of the reservation.

Name	Description
`BOOKED`	Reservation is booked and confirmed.
`CANCELLED`	Reservation is cancelled.

ReservationValueAddedPromotion

Object

Value add promotion(s) used to book the reservation.

Field	Description
`description`	Not nullable. Description of the value add promotion. Type: String
`id`	Not nullable. ID of the promotion. Type: String

String

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

SupplierLoyaltyPlanInfo

Object

Details about the frequent traveler reward program.

Field	Description
`membershipNumber`	Not nullable. Traveler's membership number. Type: Int
`planCode`	Not nullable. Reward program code. Type: String

SupplierOperatingModelType

Enum

Type of supplier operating model used for the reservation.

Name	Description
`AGENCY`	Partner operates on an agency model.
`MERCHANT`	Partner operates on a merchant model.

UpdateReservationInput

InputObject

Input object for updating a reservation.

Field	Description
`adultCount`	New adult count of the reservation. Type: Int
`checkInDate`	New check-in date (format: YYYY-MM-DD) of the reservation. Type: Date
`checkOutDate`	New checkout date (format: YYYY-MM-DD) of the reservation. Type: Date
`childAges`	Ages of children as per new child counts. If not specified, defaults to a list of random child ages. Type: Array of non nullable Int
`childCount`	New child count of the reservation. Type: Int
`clientMutationId`	Partner's transaction ID that uniquely identifies the request, which can be used to associate requests and responses for troubleshooting purposes. This ID must be unique across requests and cannot be reused. However, if a request needs to be retried, such as because it failed or timed out, the ID provided in the original request should be used. The ID can be in any format as long as it uniquely identifies the request. Type: String
`id`	Not nullable. ID of the reservation to update. Type: ID
`sendNotification`	Whether to send a notification upon the change of the reservation dates. Type: Boolean
`specialRequest`	New special request text of the reservation. Type: String
`status`	New status of the reservation. Type: ReservationStatusInput

UpdateReservationPayload

Object

Response payload for the updateReservation mutation.

Field	Description
`clientMutationId`	Partner's transaction ID that identifies the request, which can be used to correlate with partner's transaction logs. This ID must be unique across requests and cannot be reused. Type: String
`reservation`	Not nullable. Details about the reservation that was updated. Type: Reservation

Availability and rates APIs

Booking APIs

Property mgmt APIs

Developer Tools

Sandbox Data Mgmt API

updateReservation mutation

Syntax

Example

Arguments

Types

Availability and rates APIs

Booking APIs

Property mgmt APIs

Developer Tools

Sandbox Data Mgmt API

updateReservation mutationCopy link

Syntax

Example

Arguments

Types

updateReservation mutation