Cancel an existing reservation for a single room.
To cancel an entire multi-room booking, each room on the itinerary must be cancelled individually.
An error will always return when cancelling static test bookings. This is normal - you are requesting the cancellation of a booking that technically never existed.
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>yourEMail@yourDomain.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 &email=yourEMail@yourDomain.com &reason=COP &confirmationNumber=xxxxxxxx
Example JSON Response: