Use this method to cancel a reservation.

Use this method to cancel a reservation after a user-initiated action. The reservation is not removed from our database. Its status changes to cancelled and allotment is restored.

URL Endpoint

/reservation/cancel/{res_id}

Ownership

In order to cancel a reservation you must be the owner. Ownership is defined as follows:

  • For Hotelier API accounts all property reservations.
  • For Source API accounts only reservations made by that source.
  • For Agent API accounts only reservations made by that agent.

Public API accounts cannot cancel reservations.

Warning

The API user is responsible for notifying the property and the customer of the cancellation.

If you also like our system to send a cancellation confirmation e-mail make sure you pass the confirmation_email parameter. Alternatively, you can call /reservation/confirmation_email after a successful cancellation to send the cancellation confirmation e-mail.

Cancellation Fees & Handling

API user is responsible for correctly applying cancellation fees when required or handling the cancellation based on hotel terms. Failure to do so may result in a ban.

Additional Parameters

NAME TYPE RANGE / SET REQUIRED DEFAULT EXAMPLE NOTES
confirmation_email flag NO &confirmation_email Send cancellation confirmation e-mail to the customer and hotelier.
- The default is to NOT send any automated e-mails.
- Only available via POST request as a Form param.
reason string NO &reason=Change%20of%20plans Pass cancellation reason.
- Only available via POST request as a Form param.