Cancel Booking

curl "$UNIFYSTAYS_BASE_URL/hotels/book/ubk_eGQ0dW9uV1Vi/cancel" \
  -X POST \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en"

{
  "success": true,
  "message": "Booking request accepted and is being processed.",
  "data": {
    "booking_id": "ubk_eGQ0dW9uV1Vi",
    "status": "PROCESSING",
    "is_terminal": false,
    "provider": {
      "code": "TBO",
      "booking_id": "FL1IMA",
      "booking_code": "REZ6A5A81E9",
      "hotel_confirmation_number": "HCN-482910",
      "hotel_confirmation_status": "Confirmed",
      "hotel_confirmation_note": {},
      "hotel_contact_phone": {},
      "hotel_contact_name": {},
      "raw_status": "SUCCESS",
      "message": "Booking confirmed by supplier."
    },
    "created_at": "2026-04-15T12:12:11.000Z",
    "updated_at": "2026-04-15T12:12:11.000Z",
    "next_poll_after_ms": 5000,
    "metadata": {}
  }
}

POST

hotels

book

{booking_id}

cancel

curl "$UNIFYSTAYS_BASE_URL/hotels/book/ubk_eGQ0dW9uV1Vi/cancel" \
  -X POST \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en"

{
  "success": true,
  "message": "Booking request accepted and is being processed.",
  "data": {
    "booking_id": "ubk_eGQ0dW9uV1Vi",
    "status": "PROCESSING",
    "is_terminal": false,
    "provider": {
      "code": "TBO",
      "booking_id": "FL1IMA",
      "booking_code": "REZ6A5A81E9",
      "hotel_confirmation_number": "HCN-482910",
      "hotel_confirmation_status": "Confirmed",
      "hotel_confirmation_note": {},
      "hotel_contact_phone": {},
      "hotel_contact_name": {},
      "raw_status": "SUCCESS",
      "message": "Booking confirmed by supplier."
    },
    "created_at": "2026-04-15T12:12:11.000Z",
    "updated_at": "2026-04-15T12:12:11.000Z",
    "next_poll_after_ms": 5000,
    "metadata": {}
  }
}

Use this endpoint to cancel a CONFIRMED or ON_HOLD booking. Cancellation is idempotent: a repeat request for an already cancelled or cancelling booking returns its current state rather than creating another cancellation.

Request Example

curl "$UNIFYSTAYS_BASE_URL/hotels/book/ubk_eGQ0dW9uV1Vi/cancel" \
  -X POST \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en"

Handle Cancellation State

Status	Meaning	Next action
`CANCELLED`	The supplier cancellation is complete.	Show the final cancellation outcome.
`CANCELLATION_PENDING`	The supplier is processing cancellation asynchronously.	Poll Get Booking Status.

Keep the returned booking_id and request ID in your support record. If the request returns CANCELLATION_PENDING, do not assume the booking is cancelled until status polling reports CANCELLED or another final state.

Booking cancellation follows the supplier’s current terms. Retrieve booking details and show applicable cancellation information to the customer before they confirm the cancellation action.

The OpenAPI section below documents the required booking ID, success response, and error response.

Authorizations

x-api-key

string

header

required

Environment-specific API key created in the Unifystays portal

Headers

Path Parameters

booking_id

string

required

Example:

"ubk_eGQ0dW9uV1Vi"

Response

success

boolean

required

Example:

true

message

string

required

Example:

"Booking request accepted and is being processed."

data

object

required

Show child attributes

⌘I

Overview

Destination & master data

Search & hotels

Bookings

Request Example

Handle Cancellation State

Authorizations

Headers

Path Parameters

Response

​Request Example

​Handle Cancellation State

Authorizations

Headers

Path Parameters

Response

Request Example

Handle Cancellation State