UBIO Hotel Universe API

# Room Rates

The Room Rates endpoint allows you to retrieve pricing information for hotel rooms based on specified search criteria. This endpoint is part of our Smart Feed API and provides detailed room availability and pricing data.

# Authentication & Authorization

It follows standard UBIO authentication and authorization process. Please refer to the authentication documentation for more details.

# Common Response Codes

  • 200 OK - Request successful
  • 400 Bad Request - Invalid request parameters
  • 401 Unauthorized - Invalid or missing authentication
  • 403 Forbidden - Valid authentication but insufficient permissions
  • 404 Not Found - Resource not found
  • 500 Server Error - Internal server error

# Room Object Structure

Field Type Description
name string Name of the room type
id string Unique identifier for the room
description string Detailed description of the room
capacity number Maximum number of guests the room can accommodate
rates array Array of rate objects containing pricing information

# API Endpoint

GET /Pull/Hotel/{hotelId}/RoomRates

Returns room rates and availability information for a specific hotel.

# Base URL

https://hotels.automationcloud.net

# Headers

  • Authorization (string, required): The basic authorization header to authorize against the API.

    • Format: Authorization: Basic {base64_encoded_credentials}
    • Example: Authorization: Basic QVBJX0tFWTo=

    Note: You must include valid API credentials encoded in base64 format. Contact your system administrator for proper authentication credentials.

# Path Parameters

Parameter Type Required Description
hotelId string Yes The unique identifier of the hotel

# Query Parameters

Parameter Type Required Description
checkIn string Yes Check-in date in YYYY-MM-DD format
nights number Yes Number of nights for the stay
guests array Yes Array of guest numbers for each room
currency string No Currency code for rates (default: USD)
language string No Language code for descriptions (default: en)

# Example Request

curl -X GET 'https://hotels.automationcloud.net/Pull/Hotel/hotel-id-333/RoomRates?checkIn=2024-03-20&nights=2&guests=2&currency=USD&language=en' \
    -H 'Authorization: Basic QVBJX0tFWTo='

# Success Response (200)

When successful, the API returns a JSON object containing room rates and availability information.

# Response Schema

{
  "hotelId": "string",
  "checkIn": "string",
  "nights": "number",
  "guests": ["number"],
  "rooms": [
    {
      "name": "string",
      "id": "string",
      "description": "string",
      "capacity": "number",
      "rates": [
        {
          "rateId": "string",
          "price": "number",
          "currency": "string",
          "cancellationPolicy": "string",
          "boardBasis": "string",
          "available": "boolean"
        }
      ]
    }
  ]
}

# Response Example

{
  "hotelId": "hotel-id-333",
  "checkIn": "2024-03-20",
  "nights": 2,
  "guests": [2],
  "rooms": [
    {
      "name": "Deluxe Room",
      "id": "room-123",
      "description": "Spacious room with city view",
      "capacity": 2,
      "rates": [
        {
          "rateId": "rate-456",
          "price": 150.00,
          "currency": "USD",
          "cancellationPolicy": "Free cancellation until 24h before check-in",
          "boardBasis": "Room Only",
          "available": true
        }
      ]
    }
  ]
}

# Error Responses

# 401 Unauthorized

{
  "object": "error",
  "name": "EndpointAccessAuthorizationError",
  "message": "Access to the endpoint is not authorised",
  "details": {}
}

Authenticated user doesn't have access to this endpoint.

# 404 Not Found

{
  "object": "error",
  "name": "HttpRequestFailed",
  "message": "404 - GET https://hotels.automationcloud.net/Pull/Hotel/{hotelId}/RoomRates",
  "details": {}
}

There's no hotel with the ID you provided or you don't have access to this hotel.

← Room Rates Push →