07 Cancel booking

View as Markdown
Cancels a quote or a confirmed booking. No request body. The booking is **not** deleted. Its status becomes `cancelled` and it stays readable through all three lookup endpoints. The response is the full cancelled booking. ### Side effects - A cancellation email goes to the booker. - Our operations team is notified. - **No refund is issued and no invoice is voided.** Cancelling a confirmed, invoiced booking leaves the money side untouched, so raise anything financial with GAC separately. ### Responses | Status | `error_code` | When | | --- | --- | --- | | `200` | — | Cancelled. `message` is `Booking has been canceled!` | | `404` | `booking_not_found` | Unknown id, or a booking that is not yours. | | `401` | `unauthenticated` | Bearer token missing, invalid or expired. | | `500` | `server_error` | Our fault. Nothing was changed. | Works from any status, including one already cancelled. A second cancel returns `200` again and the booking is unchanged, **but the cancellation email is sent again**, so do not retry blindly. Check `status` first with **09 Get booking by ID** if you are not sure. Cancelling is final as far as this API is concerned. There is no un-cancel; every other endpoint then answers `409 booking_cancelled`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

OK
messagestring
statusinteger
responseTimestring
tracelist of any
dataobject

Errors

404
Not Found Error