Cancel an existing reservation for a single room.
To cancel an entire multi-room booking, each room on the itinerary must be cancelled individually.
If you need help parsing or messaging hotel cancellation penalties, please see our documentation on the
An error will always return when cancelling static test bookings. This is normal - test bookings are never entered in our payment, lodging, or inventory systems.
To verify your test cancellation, look for our automated post-cancellation email after your test, or use a follow-up itinerary request.
If you receive an error when cancelling a live booking, refer to our cancellation errors page.
|XML Parent Element:||
||long||yes||The itinerary ID provided at the time of the reservation.|
|string||yes||The email address that was provided at the time of the reservation.|
||string||yes||The confirmation number for the room to be cancelled.
Remember that multi-room bookings must be cancelled one room at a time in separate requests - sending multiple confirmation numbers in a single request will not work.
||string||no||Reason code for the cancellation, if appropriate. This is not required and typically does not affect the processing of the cancellation.
||string||Reference number for the cancellation, if successful. Customers should continue to retain their itinerary and confirmation numbers in addition to this number for any further correspondence.|
Example XML Request:
http://api.ean.com/ean-services/rs/hotel/v3/cancel? minorRev=[current minorRev #] &cid=55505 &apiKey=[xxx-yourOwnKey-xxx] &customerUserAgent=[xxx] &customerIpAddress=[xxx] &customerSessionId=[xxx] &locale=en_US ¤cyCode=USD &xml= <HotelRoomCancellationRequest> <itineraryId>xxxxxxx</itineraryId> <email>email@example.com</email> <reason>COP</reason> <confirmationNumber>xxxxxxxx</confirmationNumber> </HotelRoomCancellationRequest>
Example XML Response:
<ns2:HotelRoomCancellationResponse> <customerSessionId>XXXX</customerSessionId> <cancellationNumber>XXXXXX</cancellationNumber> </ns2:HotelRoomCancellationResponse>
Example REST Request:
http://api.ean.com/ean-services/rs/hotel/v3/cancel? minorRev=[current minorRev #] &cid=55505 &apiKey=[xxx-yourOwnKey-xxx] &customerUserAgent=[xxx] &customerIpAddress=[xxx] &customerSessionId=[xxx] &locale=en_US ¤cyCode=USD &itineraryId=xxxxxxx &firstname.lastname@example.org &reason=COP &confirmationNumber=xxxxxxxx
Example JSON Response: