Cancel Reservation

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


Request Formats
XML/REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/cancel?
XML Parent Element: <HotelRoomCancellationRequest>



Request Parameters

Base Parameters
Name Value Required Description
itineraryId long yes The itinerary ID provided at the time of the reservation.
email string yes The email address that was provided at the time of the reservation.
confirmationNumber 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.
reason string no Reason code for the cancellation, if appropriate. This is not required and typically does not affect the processing of the cancellation.

Values:
HOC: Hotel asked me to cancel
COP: Change of plans
FBP: Found a better price
FBH: Found a better hotel
CNL: Decided to cancel my plans
NSY: Rather not say
OTH: Other


Response Content
Parent Element: HotelRoomCancellationResponse

Name Value Description
cancellationNumber 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
&currencyCode=USD
&xml=
<HotelRoomCancellationRequest>
	<itineraryId>xxxxxxx</itineraryId>
	<email>email@domain.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
&currencyCode=USD
&itineraryId=xxxxxxx
&email=email@domain.com
&reason=COP
&confirmationNumber=xxxxxxxx 

Example JSON Response:

{"HotelRoomCancellationResponse":{"customerSessionId":"XXXX","cancellationNumber":"XXXXX"}}