Get Room Options

curl "$UNIFYSTAYS_BASE_URL/hotels/123456/rooms" \
  -X POST \
  -H "content-type: application/json" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en" \
  -d '{
    "check_in": "2026-09-12",
    "check_out": "2026-09-15",
    "nationality": "IN",
    "rooms": [
      {
        "adults": 2,
        "child_ages": []
      }
    ]
  }'

{
  "success": true,
  "message": "Rooms fetched successfully",
  "data": {
    "hotel_id": "123456",
    "hotel_name": "The Taj Mahal Palace",
    "check_in": "2026-07-01",
    "check_out": "2026-07-04",
    "nights": 3,
    "total_options": 2,
    "providers_queried": [
      "TBO",
      "TRIPJACK"
    ],
    "unifystays_rooms": [
      {
        "room_id": "1001",
        "room_name": "Deluxe King Room",
        "description": "Spacious room with king bed and city view.",
        "room_size_value": 32,
        "room_size_unit": "sqm",
        "bed_relation": "King Bed",
        "max_adults": 2,
        "max_children": 1,
        "max_occupancy": 3,
        "bed_types": {},
        "amenities": {},
        "photos": {},
        "views": {}
      }
    ],
    "stream_id": "stream_8f4b9d1f6d9e",
    "sse_stream_url": "/hotels/123456/rooms/stream/stream_8f4b9d1f6d9e",
    "options": [
      {
        "provider_code": "TBO",
        "booking_token": "bq1.Y0QxTmtKc21Wbmk.3.6zI4D6fUEw2jVv7KQdM4Kw",
        "rooms": [
          {
            "provider_room_name": "Luxury Room, 1 King Bed",
            "unifystays_room_id": "1001"
          }
        ],
        "pricing": {
          "supplier_breakup": {
            "currency": "GBP",
            "total_payable_now": 66227,
            "total_payable_at_property": 6000,
            "base_price": 52452,
            "breakdown": [
              {
                "category": "tax",
                "amount": 13775,
                "payable_at": "now",
                "description": "standard_tax"
              }
            ]
          },
          "converted_breakup": {
            "currency": "USD",
            "total_payable_now": 84108,
            "total_payable_at_property": 7620,
            "base_price": 66614,
            "breakdown": [
              {
                "category": "tax",
                "amount": 13775,
                "payable_at": "now",
                "description": "standard_tax"
              }
            ],
            "exchange_rate": {
              "rate": 1.2715,
              "rate_updated_at": "2026-04-14T08:41:22.000Z"
            }
          }
        },
        "meal_plan": {
          "code": "BB",
          "label": "Bed & Breakfast",
          "is_breakfast_included": true
        },
        "compliance": {
          "requires_passport": true,
          "special_requirements": [
            {
              "type": "LOCAL_ID",
              "description": "PAN Card or Aadhaar required for Indian Nationals",
              "applies_to": "IN"
            }
          ]
        },
        "cancellation": {
          "is_refundable": true,
          "policy_text": "Free cancellation until May 18, 2026, hotel local time. After this date, a 100% penalty applies.",
          "penalties": [
            {
              "from_date": "2026-02-10T19:07:00Z",
              "to_date": "2026-05-18T23:59:59Z",
              "supplier_currency": "GBP",
              "supplier_amount": 0,
              "converted_currency": "USD",
              "converted_amount": 0,
              "description": "Free Cancellation Window",
              "local_time_policy": {
                "display_text": "Free until May 18th (Hotel Local Time)",
                "hotel_timezone": "Europe/London"
              }
            }
          ],
          "free_cancellation_until": "2026-05-18T23:59:59Z"
        },
        "tags": [
          "Free Cancellation",
          "Breakfast Included"
        ],
        "promotions": [
          "Private sale"
        ],
        "metadata": {
          "extra_guest_charge": 0,
          "recommended_selling_rate": 140
        },
        "inclusion": "Free WiFi"
      }
    ]
  }
}

POST

hotels

{hotel_id}

rooms

curl "$UNIFYSTAYS_BASE_URL/hotels/123456/rooms" \
  -X POST \
  -H "content-type: application/json" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en" \
  -d '{
    "check_in": "2026-09-12",
    "check_out": "2026-09-15",
    "nationality": "IN",
    "rooms": [
      {
        "adults": 2,
        "child_ages": []
      }
    ]
  }'

{
  "success": true,
  "message": "Rooms fetched successfully",
  "data": {
    "hotel_id": "123456",
    "hotel_name": "The Taj Mahal Palace",
    "check_in": "2026-07-01",
    "check_out": "2026-07-04",
    "nights": 3,
    "total_options": 2,
    "providers_queried": [
      "TBO",
      "TRIPJACK"
    ],
    "unifystays_rooms": [
      {
        "room_id": "1001",
        "room_name": "Deluxe King Room",
        "description": "Spacious room with king bed and city view.",
        "room_size_value": 32,
        "room_size_unit": "sqm",
        "bed_relation": "King Bed",
        "max_adults": 2,
        "max_children": 1,
        "max_occupancy": 3,
        "bed_types": {},
        "amenities": {},
        "photos": {},
        "views": {}
      }
    ],
    "stream_id": "stream_8f4b9d1f6d9e",
    "sse_stream_url": "/hotels/123456/rooms/stream/stream_8f4b9d1f6d9e",
    "options": [
      {
        "provider_code": "TBO",
        "booking_token": "bq1.Y0QxTmtKc21Wbmk.3.6zI4D6fUEw2jVv7KQdM4Kw",
        "rooms": [
          {
            "provider_room_name": "Luxury Room, 1 King Bed",
            "unifystays_room_id": "1001"
          }
        ],
        "pricing": {
          "supplier_breakup": {
            "currency": "GBP",
            "total_payable_now": 66227,
            "total_payable_at_property": 6000,
            "base_price": 52452,
            "breakdown": [
              {
                "category": "tax",
                "amount": 13775,
                "payable_at": "now",
                "description": "standard_tax"
              }
            ]
          },
          "converted_breakup": {
            "currency": "USD",
            "total_payable_now": 84108,
            "total_payable_at_property": 7620,
            "base_price": 66614,
            "breakdown": [
              {
                "category": "tax",
                "amount": 13775,
                "payable_at": "now",
                "description": "standard_tax"
              }
            ],
            "exchange_rate": {
              "rate": 1.2715,
              "rate_updated_at": "2026-04-14T08:41:22.000Z"
            }
          }
        },
        "meal_plan": {
          "code": "BB",
          "label": "Bed & Breakfast",
          "is_breakfast_included": true
        },
        "compliance": {
          "requires_passport": true,
          "special_requirements": [
            {
              "type": "LOCAL_ID",
              "description": "PAN Card or Aadhaar required for Indian Nationals",
              "applies_to": "IN"
            }
          ]
        },
        "cancellation": {
          "is_refundable": true,
          "policy_text": "Free cancellation until May 18, 2026, hotel local time. After this date, a 100% penalty applies.",
          "penalties": [
            {
              "from_date": "2026-02-10T19:07:00Z",
              "to_date": "2026-05-18T23:59:59Z",
              "supplier_currency": "GBP",
              "supplier_amount": 0,
              "converted_currency": "USD",
              "converted_amount": 0,
              "description": "Free Cancellation Window",
              "local_time_policy": {
                "display_text": "Free until May 18th (Hotel Local Time)",
                "hotel_timezone": "Europe/London"
              }
            }
          ],
          "free_cancellation_until": "2026-05-18T23:59:59Z"
        },
        "tags": [
          "Free Cancellation",
          "Breakfast Included"
        ],
        "promotions": [
          "Private sale"
        ],
        "metadata": {
          "extra_guest_charge": 0,
          "recommended_selling_rate": 140
        },
        "inclusion": "Free WiFi"
      }
    ]
  }
}

Call this endpoint after the customer selects a hotel. Send the same dates, occupancy, and nationality used for hotel search. Unifystays calls the active suppliers in parallel and normalizes their room options.

Request Example

curl "$UNIFYSTAYS_BASE_URL/hotels/123456/rooms" \
  -X POST \
  -H "content-type: application/json" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en" \
  -d '{
    "check_in": "2026-09-12",
    "check_out": "2026-09-15",
    "nationality": "IN",
    "rooms": [
      {
        "adults": 2,
        "child_ages": []
      }
    ]
  }'

Use the Response

The response contains the static room catalogue, supplier options, and a stream_id with sse_stream_url for progressive provider results. Every bookable option includes a short signed booking_token required by Prebook a Room.

An option can have our_room: null and still be bookable.
Keep the selected option’s booking_token only for the immediate prebook step; it is time-sensitive.
Use the room stream when your product needs to render options as providers return them. See Stream Room Updates.
Request fresh room options if the stay dates, guest mix, nationality, or selected hotel changes.

Do not cache room options or reuse their booking tokens as a checkout guarantee. Supplier-backed availability and price can change.

The OpenAPI section below provides the complete request body and response fields, including room options and stream identifiers.

Authorizations

x-api-key

string

header

required

Environment-specific API key created in the Unifystays portal

Headers

Path Parameters

hotel_id

string

required

Internal hotel ID (bigint as string)

Example:

"123456"

Body

application/json

check_in

string

required

Check-in date in YYYY-MM-DD format. Must be today or a future date.

Example:

"2026-07-01"

check_out

string

required

Check-out date in YYYY-MM-DD format. Must be after check_in.

Example:

"2026-07-04"

rooms

object[]

required

Room configurations — 1 to 5 rooms. Each room specifies adults and optional child ages.

Required array length: 1 - 5 elements

Show child attributes

Example:

[{ "adults": 2, "child_ages": [] }]

nationality

string

default:IN

Guest nationality — ISO alpha-2 code (e.g. IN, AE, US). Defaults to IN.

Example:

"IN"

Response

success

boolean

required

Example:

true

message

string

required

Example:

"Rooms fetched successfully"

data

object

required

Show child attributes

⌘I

Overview

Destination & master data

Search & hotels

Bookings

Request Example

Use the Response

Authorizations

Headers

Path Parameters

Body

Response

​Request Example

​Use the Response

Authorizations

Headers

Path Parameters

Body

Response

Request Example

Use the Response