Get Booking Status

curl "$UNIFYSTAYS_BASE_URL/hotels/book/ubk_eGQ0dW9uV1Vi" \
  -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": {}
  }
}

GET

hotels

book

{booking_id}

curl "$UNIFYSTAYS_BASE_URL/hotels/book/ubk_eGQ0dW9uV1Vi" \
  -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 poll a booking after Create Booking or Cancel Booking. It returns the current unified state without retrieving the full itinerary payload.

Request Example

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

Polling Guidance

Save the booking ID

Store data.booking_id from the booking creation response.

Read the current state

Display data.status to the customer or support user.

Stop when final

Use data.is_terminal to decide when the operation is complete.

Load the itinerary when needed

Use Get Booking Details for confirmed itineraries, support views, and reconciliation.

After a cancellation request, CANCELLATION_PENDING means the supplier is still processing it. Continue polling until the status becomes CANCELLED or the response indicates a final state. The OpenAPI section below contains the status response and error contract.

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

Polling Guidance

Authorizations

Headers

Path Parameters

Response

​Request Example

​Polling Guidance

Authorizations

Headers

Path Parameters

Response

Request Example

Polling Guidance