Hotel

The hotel endpoint allows you to retrieve detailed information about a specific hotel, including all available rates from an availability session. This is typically the second step in the booking flow after searching for availability.

The hotel details response model

HotelDetailsResponse

Name
session_id
Type
string
Description
Session identifier (UUID) from the availability search.
Name
search_completed
Type
boolean
Description
Whether the search has completed across all vendors.
Name
hotel
Type
HotelDetails
Description
Complete hotel information.
Name
rates
Type
array of HotelRate
Description
All available rates for this hotel.
Name
metadata
Type
HotelMetadata
Description
Metadata about the search.
Name
expires_at
Type
string
Description
ISO 8601 timestamp when this session expires.

HotelDetails object

Name
id
Type
integer
Description
Unique hotel identifier.
Name
name
Type
string
Description
Hotel name.
Name
stars
Type
number
Description
Star rating (1.0-5.0).
Name
rating
Type
number
Description
Guest rating score.
Name
review_count
Type
integer
Description
Number of guest reviews.
Name
lowest_rate
Type
HotelRate
Description
The lowest priced rate for quick display.
Name
lowest_brand_loyalty_rate
Type
HotelRate
Description
Lowest rate eligible for loyalty points.
Name
minimum_age
Type
integer
Description
Minimum guest age requirement.
Name
amenities
Type
array of HotelAmenity
Description
List of hotel amenities. See Enums section.
Name
check_in_begin_time
Type
string
Description
Earliest check-in time (HH:MM format).
Name
check_in_end_time
Type
string
Description
Latest check-in time (HH:MM format).
Name
check_out_before_time
Type
string
Description
Check-out deadline (HH:MM format).
Name
description
Type
string
Description
Hotel description text.
Name
images
Type
array of strings
Description
Array of image URLs.
Name
coordinates
Type
Coordinates
Description
Geographic coordinates.
Name
address
Type
HotelAddress
Description
Hotel address details.
Name
type
Type
string
Description
Property type (e.g., "hotel", "resort").
Name
exclusive
Type
boolean
Description
Whether this is an exclusive/premium property.

HotelAddress object

Name
address
Type
string
Description
Street address.
Name
city
Type
string
Description
City name.
Name
country
Type
string
Description
Country code or name.
Name
postal_code
Type
string
Description
Postal/ZIP code.
Name
region
Type
string
Description
State/province/region.

HotelMetadata object

Name
nights
Type
integer
Description
Number of nights for the stay.
Name
rooms
Type
integer
Description
Number of rooms in the search.

HotelRate object

Name
id
Type
string
Description
Unique rate identifier (UUID). Use this for prebook/book calls.
Name
hotel_id
Type
integer
Description
Associated hotel ID.
Name
rooms
Type
array of HotelRateRoom
Description
Room details for this rate.
Name
price_per_night_avg
Type
number
Description
Average price per night.
Name
price_per_night
Type
array of numbers
Description
Price for each night of the stay.
Name
price_chargeable
Type
number
Description
Total amount to charge the customer.
Name
price_per_room
Type
array of numbers
Description
Total price per room.
Name
price_per_night_per_room
Type
array of array of numbers
Description
Price breakdown per night per room.
Name
price_before_fees
Type
number
Description
Price before taxes and fees.
Name
price_fees
Type
number
Description
Taxes and fees amount.
Name
price_due_at_hotel
Type
number
Description
Amount payable at hotel (e.g., resort fees).
Name
price_inclusive
Type
number
Description
Total inclusive price.
Name
price_currency
Type
string
Description
Currency code (e.g., "USD").
Name
price_retail
Type
number
Description
Retail/comparison price if available.
Name
cancellation_policy
Type
HotelRateCancellationPolicy
Description
Either "Refundable" or "NonRefundable".
Name
cancellation_policy_datetime
Type
string
Description
Free cancellation deadline (ISO 8601).
Name
cancellation_policy_data
Type
array of CancellationPolicyData
Description
Detailed cancellation penalty schedule.
Name
brand_loyalty_eligible
Type
boolean
Description
Whether loyalty points can be earned.
Name
brand_loyalty_required
Type
boolean
Description
Whether loyalty number is required to book.
Name
brand_loyalty_name
Type
string
Description
Loyalty program name (e.g., "Marriott Bonvoy").
Name
elite
Type
HotelRateElite
Description
Elite/premium rate benefits if applicable.
Name
price_commission
Type
number
Description
Commission amount.
Name
price_commission_currency
Type
string
Description
Commission currency code.
Name
payment_type
Type
string
Description
Payment type: "account" or "credit_card".

HotelRateRoom object

Name
name
Type
string
Description
Room name/type (e.g., "Deluxe King Room").
Name
board
Type
HotelRateBoardType
Description
Board type: RO, BB, HB, FB, or AI.
Name
room_data
Type
HotelRateRoomData
Description
Detailed room information.
Name
price_per_night_avg
Type
number
Description
Average price per night for this room.
Name
price_per_night
Type
array of numbers
Description
Price for each night.
Name
price_chargeable
Type
number
Description
Total chargeable amount for this room.
Name
price_per_room
Type
number
Description
Total price for this room.
Name
price_before_fees
Type
number
Description
Price before fees.
Name
price_fees
Type
number
Description
Fees amount.
Name
price_due_at_hotel
Type
number
Description
Amount due at hotel.
Name
price_inclusive
Type
number
Description
Inclusive price.
Name
price_currency
Type
string
Description
Currency code.
Name
fees
Type
array of HotelRateFee
Description
Itemized fees.
Name
deposit_per_accomodation_per_night
Type
number
Description
Deposit amount per accommodation per night.
Name
deposit_currency
Type
string
Description
Deposit currency.
Name
adults
Type
integer
Description
Number of adults this room accommodates.
Name
children
Type
integer
Description
Number of children this room accommodates.
Name
children_ages
Type
array of integers
Description
Ages of children.

HotelRateRoomData object

Name
images
Type
array of strings
Description
Room image URLs.
Name
size_sqft
Type
integer
Description
Room size in square feet.
Name
size_sqm
Type
integer
Description
Room size in square meters.
Name
max_occupancy
Type
integer
Description
Maximum total occupancy.
Name
max_adults
Type
integer
Description
Maximum adults allowed.
Name
max_children
Type
integer
Description
Maximum children allowed.
Name
beds
Type
array of HotelRateRoomBedType
Description
Bed configuration.
Name
amenities
Type
array of RoomAmenity
Description
Room amenities. See Enums section.
Name
room_id
Type
integer
Description
Internal room type identifier.

HotelRateRoomBedType object

Name
name
Type
string
Description
Bed type name (e.g., "King", "Queen", "Twin").
Name
size
Type
string
Description
Bed size description.
Name
quantity
Type
integer
Description
Number of beds of this type.

HotelRateFee object

Name
name
Type
string
Description
Fee name/description.
Name
price
Type
number
Description
Fee amount.
Name
due_at_hotel
Type
boolean
Description
Whether this fee is paid at the hotel.
Name
price_currency
Type
string
Description
Fee currency.

CancellationPolicyData object

Name
from_datetime
Type
string
Description
Start datetime for this penalty period (ISO 8601).
Name
price_cancellation_penalty
Type
number
Description
Penalty amount if cancelled during this period.
Name
price_currency
Type
string
Description
Penalty currency.

HotelRateElite object

Name
room_upgrade_guaranteed
Type
boolean
Description
Guaranteed room upgrade.
Name
room_upgrade_subject_availability
Type
boolean
Description
Room upgrade subject to availability.
Name
late_checkout_guaranteed
Type
boolean
Description
Guaranteed late checkout.
Name
late_checkout_subject_availability
Type
boolean
Description
Late checkout subject to availability.
Name
welcome_amenity
Type
boolean
Description
Welcome amenity included.
Name
description
Type
array of strings
Description
Elite benefit descriptions.
Name
price_property_credit
Type
number
Description
Property credit amount.
Name
price_property_credit_currency
Type
string
Description
Property credit currency.
Name
property_credit_description
Type
string
Description
Property credit description.
Name
breakfast_included
Type
boolean
Description
Breakfast included.
Name
breakfast_description
Type
string
Description
Breakfast details.
Name
breakfast_pax
Type
integer
Description
Number of guests breakfast covers.
Name
travel_agent
Type
boolean
Description
Travel agent rate.

Coordinates object

Name
lat
Type
number
Description
Latitude.
Name
lng
Type
number
Description
Longitude.

Enums

HotelAmenity enum

Hotel-level amenities:

accessibility-mobility - Accessibility features for mobility
adult-only - Adults only property
business-centre - Business center available
cash-machine - ATM/cash machine on-site
childcare-service - Childcare services available
concierge - Concierge services
gym - Fitness center/gym
laundry - Laundry services
lounge - Lounge area
parking - Parking available
pets-allowed - Pets allowed
pool - Swimming pool
restaurant - Restaurant on-site
room-service - Room service available
spa - Spa facilities
24-hour-front-desk - 24-hour front desk
wifi - WiFi available

HotelRateBoardType enum

Board/meal plan types:

RO - Room Only (no meals)
BB - Bed & Breakfast
HB - Half Board (breakfast + dinner)
FB - Full Board (all meals)
AI - All Inclusive (meals + drinks)

HotelRateCancellationPolicy enum

Refundable - Can be cancelled with full or partial refund before deadline
NonRefundable - No refund if cancelled

GET/v1/hotel/:hotel_id/:session_id

Get hotel with session

This endpoint retrieves detailed hotel information and all available rates from an availability session. Use this to display the hotel details page before booking.

Path parameters

Name
hotel_id
Type
integer
Description
The hotel identifier.
Name
session_id
Type
uuid
Description
The session ID from availability search.

Query parameters

Name
maprooms
Type
boolean
Description
Include room mapping data. Default: false.

Request

GET

/v1/hotel/1234/550e8400-e29b-41d4-a716-446655440000

curl https://api.tripedge.com/v1/hotel/1234/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer {token}"

Response

{
  "data": {
    "session_id": "550e8400-e29b-41d4-a716-446655440000",
    "search_completed": true,
    "hotel": {
      "id": 1234,
      "name": "Grand Hotel New York",
      "stars": 5.0,
      "rating": 4.5,
      "review_count": 1200,
      "lowest_rate": null,
      "lowest_brand_loyalty_rate": null,
      "minimum_age": 18,
      "amenities": ["pool", "spa", "wifi", "gym", "restaurant", "24-hour-front-desk"],
      "check_in_begin_time": "15:00",
      "check_in_end_time": "23:00",
      "check_out_before_time": "11:00",
      "description": "Luxury hotel in the heart of Manhattan with stunning city views...",
      "images": [
        "https://images.tripedge.com/hotels/1234/main.jpg",
        "https://images.tripedge.com/hotels/1234/lobby.jpg",
        "https://images.tripedge.com/hotels/1234/pool.jpg"
      ],
      "coordinates": {
        "lat": 40.7128,
        "lng": -74.0060
      },
      "address": {
        "address": "123 Main Street",
        "city": "New York",
        "country": "US",
        "postal_code": "10001",
        "region": "NY"
      },
      "type": "hotel",
      "exclusive": false
    },
    "rates": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "hotel_id": 1234,
        "rooms": [
          {
            "name": "Deluxe King Room",
            "board": "BB",
            "room_data": {
              "images": ["https://images.tripedge.com/rooms/deluxe-king.jpg"],
              "size_sqft": 450,
              "size_sqm": 42,
              "max_occupancy": 3,
              "max_adults": 2,
              "max_children": 1,
              "beds": [
                {
                  "name": "King",
                  "size": "king",
                  "quantity": 1
                }
              ],
              "amenities": ["minibar", "safe", "balcony", "air_conditioning", "wireless_internet", "flat_screen_tv"],
              "room_id": 101
            },
            "price_per_night_avg": 250.00,
            "price_per_night": [250.00, 250.00, 250.00],
            "price_chargeable": 750.00,
            "price_per_room": 750.00,
            "price_before_fees": 700.00,
            "price_fees": 50.00,
            "price_due_at_hotel": 0.00,
            "price_inclusive": 750.00,
            "price_currency": "USD",
            "fees": [
              {
                "name": "City Tax",
                "price": 30.00,
                "due_at_hotel": false,
                "price_currency": "USD"
              },
              {
                "name": "Service Fee",
                "price": 20.00,
                "due_at_hotel": false,
                "price_currency": "USD"
              }
            ],
            "deposit_per_accomodation_per_night": null,
            "deposit_currency": null,
            "adults": 2,
            "children": 1,
            "children_ages": [5]
          }
        ],
        "price_per_night_avg": 250.00,
        "price_per_night": [250.00, 250.00, 250.00],
        "price_chargeable": 750.00,
        "price_per_room": [750.00],
        "price_per_night_per_room": [[250.00, 250.00, 250.00]],
        "price_before_fees": 700.00,
        "price_fees": 50.00,
        "price_due_at_hotel": 0.00,
        "price_inclusive": 750.00,
        "price_currency": "USD",
        "price_retail": 850.00,
        "cancellation_policy": "Refundable",
        "cancellation_policy_datetime": "2024-03-14T23:59:00Z",
        "cancellation_policy_data": [
          {
            "from_datetime": "2024-03-14T23:59:00Z",
            "price_cancellation_penalty": 250.00,
            "price_currency": "USD"
          }
        ],
        "brand_loyalty_eligible": true,
        "brand_loyalty_required": false,
        "brand_loyalty_name": "Marriott Bonvoy",
        "elite": null,
        "price_commission": 75.00,
        "price_commission_currency": "USD",
        "payment_type": "account"
      },
      {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "hotel_id": 1234,
        "rooms": [
          {
            "name": "Standard Queen Room",
            "board": "RO",
            "room_data": {
              "images": ["https://images.tripedge.com/rooms/standard-queen.jpg"],
              "size_sqft": 350,
              "size_sqm": 33,
              "max_occupancy": 2,
              "max_adults": 2,
              "max_children": 0,
              "beds": [
                {
                  "name": "Queen",
                  "size": "queen",
                  "quantity": 1
                }
              ],
              "amenities": ["safe", "air_conditioning", "wireless_internet", "tv"],
              "room_id": 102
            },
            "price_per_night_avg": 180.00,
            "price_per_night": [180.00, 180.00, 180.00],
            "price_chargeable": 540.00,
            "price_per_room": 540.00,
            "price_before_fees": 500.00,
            "price_fees": 40.00,
            "price_due_at_hotel": 0.00,
            "price_inclusive": 540.00,
            "price_currency": "USD",
            "fees": [],
            "adults": 2,
            "children": 0,
            "children_ages": []
          }
        ],
        "price_per_night_avg": 180.00,
        "price_per_night": [180.00, 180.00, 180.00],
        "price_chargeable": 540.00,
        "price_per_room": [540.00],
        "price_per_night_per_room": [[180.00, 180.00, 180.00]],
        "price_before_fees": 500.00,
        "price_fees": 40.00,
        "price_due_at_hotel": 0.00,
        "price_inclusive": 540.00,
        "price_currency": "USD",
        "price_retail": 620.00,
        "cancellation_policy": "NonRefundable",
        "cancellation_policy_datetime": "",
        "cancellation_policy_data": [],
        "brand_loyalty_eligible": false,
        "brand_loyalty_required": false,
        "brand_loyalty_name": null,
        "elite": null,
        "price_commission": 54.00,
        "price_commission_currency": "USD",
        "payment_type": "account"
      }
    ],
    "metadata": {
      "nights": 3,
      "rooms": 1
    },
    "expires_at": "2024-03-15T12:00:00Z"
  },
  "success": true,
  "message": null
}

GET/v1/hotel/:hotel_id

Get hotel without session

This endpoint retrieves hotel information without an active session. Returns hotel details without rate information.

Path parameters

Name
hotel_id
Type
integer
Description
The hotel identifier.

Request

GET

/v1/hotel/1234

curl https://api.tripedge.com/v1/hotel/1234 \
  -H "Authorization: Bearer {token}"

Response

{
  "data": {
    "session_id": null,
    "search_completed": false,
    "hotel": {
      "id": 1234,
      "name": "Grand Hotel New York",
      "stars": 5.0,
      "rating": 4.5,
      "review_count": 1200,
      "lowest_rate": null,
      "lowest_brand_loyalty_rate": null,
      "minimum_age": 18,
      "amenities": ["pool", "spa", "wifi", "gym", "restaurant"],
      "check_in_begin_time": "15:00",
      "check_in_end_time": "23:00",
      "check_out_before_time": "11:00",
      "description": "Luxury hotel in the heart of Manhattan...",
      "images": ["https://images.tripedge.com/hotels/1234/main.jpg"],
      "coordinates": { "lat": 40.7128, "lng": -74.0060 },
      "address": {
        "address": "123 Main Street",
        "city": "New York",
        "country": "US",
        "postal_code": "10001",
        "region": "NY"
      },
      "type": "hotel",
      "exclusive": false
    },
    "rates": [],
    "metadata": {
      "nights": 0,
      "rooms": 0
    },
    "expires_at": null
  },
  "success": true,
  "message": null
}