{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Modifying ancillaries for an existing hotel booking","meta":[{"name":"robots","content":"noindex"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"modifying-ancillaries-for-an-existing-hotel-booking","__idx":0},"children":["Modifying ancillaries for an existing hotel booking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once a booking is confirmed, the ancillaries purchased along with the hotel booking can be modified if the hotel's policy permits it."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/hotel_guides/hotel_addons_guide#modifying-ancillaries-on-an-existing-booking---overview"},"children":["paid ancillaries"]}," guide for more information with a sample use case."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The steps below explain how to modify ancillaries on an existing hotel booking."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Step"},"children":["Step"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Name"},"children":["Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Details"},"children":["Details"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/hotelapi/hotel/hotelmodifydetails"},"children":["Modify hotel details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/hotel/pnrs/{pnrId}/modify-details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["View the ancillaries available for the booking.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL path requires:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pnrId"]}," from step 4 of the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/spotnana/hotel_booking_workflow"},"children":["creating a hotel booking"]}," workflow. If the booking has been previously modified, then use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pnrId"]}," from step 3 of the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/spotnana/hotel_modify_workflow"},"children":["modifying a hotel booking"]}," workflow.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request body requires:"]}," Occupancy details.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response will contain:"]}," An ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ancillaries"]}," array along with the room booking details. Each item in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ancillaries"]}," array includes a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["purchaseStatus"]}," field that indicates its current state (see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/hotel_guides/hotel_addons_guide#fetching-available-ancillaries"},"children":["paid ancillaries"]}," guide for more details on the purchase states).",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Other APIs will use:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rooms"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rateOptions"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["priceValidateKey"]}," and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ancillaryKey"]}," values from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ancillaries"]}," array."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/hotelapi/hotel/hotelpricecheck"},"children":["Verify hotel price"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/hotel/price-check"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify the price of the selected room rate.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request body requires:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["priceValidateKey"]}," from step 1.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response will contain:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bookingKey"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Other APIs will use:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bookingKey"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/hotelapi/hotel/hotelmodifybooking"},"children":["Modify hotel booking"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/hotel/pnrs/{pnrId}/modify-book"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Apply the updated ancillary selections to the booking.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL path requires:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pnrId"]}," from step 4 of the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/spotnana/hotel_booking_workflow"},"children":["creating a hotel booking"]}," workflow. If the booking has been previously modified, then use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pnrId"]}," from step 3 of the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/spotnana/hotel_modify_workflow"},"children":["modifying a hotel booking"]}," workflow.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request body requires:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bookingKey"]}," from step 2, traveler details, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tripId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bookingContact"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ancillaryKeys"]}," containing the full intended set of ancillary keys (i.e., the existing ancillaries to keep along with any new ancillaries to add). Omit any existing ancillary keys from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ancillaryKeys"]}," array that should be removed from the booking.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/hotel_guides/hotel_addons_guide#modifying-ancillaries-on-an-existing-booking---overview"},"children":["paid ancillaries"]}," guide for more information with a sample use case.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response will contain:"]}," A new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pnrId"]}," for the modified booking, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pnrStatus"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalPnrId"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Other APIs will use:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pnrId"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalPnrId"]}," (also referred to as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancelSourcePnrId"]},")."]}]}]}]}]}]},"headings":[{"value":"Modifying ancillaries for an existing hotel booking","id":"modifying-ancillaries-for-an-existing-hotel-booking","depth":1}],"frontmatter":{"seo":{"title":"Modifying ancillaries for an existing hotel booking"}},"lastModified":"2026-05-19T13:27:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/spotnana/hotel_modify_ancillaries_workflow","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}