HotelRates

Get detailed room rates and availability for a specific hotel with comprehensive supplier coverage.

This endpoint provides detailed room rates and availability information for a single hotel, with support for multiple suppliers and advanced filtering options. It's optimized for detailed hotel booking scenarios where comprehensive rate information is required.

Key Differences from HotelList:

Single Hotel Focus: Designed for detailed analysis of one specific hotel

Full Supplier Support: All suppliers support detailed rate queries

Required Parameters:

hotelId: The unique identifier for the target hotel

checkIn/checkOut: Check-in and check-out dates

occupancies: Guest and room configuration

sessionId (in Header): The session ID for tracking the booking process

Response Features:

Complete room package information with rates

Room type mapping and standardization

Session tracking for booking context

Common Use Cases:

Hotel detail page rate display

Room selection and comparison

Detailed booking flow initiation

Integration Notes:

Use HotelList for multi-hotel searches with basic rate info

Use HotelRates for single hotel detailed rate analysis

Session management enables seamless booking flow transitions

curl --location --request POST 'https://api-test.hotelbyte.com/api/search/hotelRates' \ --header 'Client-Request-Timestamp;' \ --header 'Currency;' \ --header 'IP;' \ --header 'Language;' \ --header 'Request-Id;' \ --header 'Session-Id;' \ --header 'Test;' \ --header 'Timeout-Milliseconds;' \ --header 'Trace-Id;' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data-raw '{ "hotelId": "461850557", "checkIn": "now()", "checkOut": "now()+7", "countryCode": "US", "residencyCode": "US", "nationalityCode": "US", "roomOccupancies": [ { "adultCount": 2, "childrenAges": [ 2 ] } ] }'

{ "code": 0, "msg": "string", "data": { "rooms": [ { "roomTypeId": "string", "roomTypeName": { "en": "string", "zh": "string", "ar": "string" }, "hotelId": "string", "rates": [ { "ratePkgId": "string", "refundableMode": "full", "refundableUntil": "2006-01-02T15:04:05Z07:00", "cancelFees": [ { "until": "2006-01-02T15:04:05Z07:00", "fee": { "currency": "string", "amount": 0 } } ], "originalRoomNaming": { "id": "string", "name": "string", "supplier": 0 }, "rate": { "commissionableRate": { "currency": "string", "amount": 0 }, "netRate": { "currency": "string", "amount": 0 }, "grossRate": { "currency": "string", "amount": 0 }, "respectGrossRate": true }, "totalRate": { "commissionableRate": { "currency": "string", "amount": 0 }, "netRate": { "currency": "string", "amount": 0 }, "grossRate": { "currency": "string", "amount": 0 }, "respectGrossRate": true }, "rateComment": "string", "includesPackaging": true, "checkIn": "now()", "checkOut": "now()+7", "board": { "boardId": "RO", "boardName": { "en": "string", "zh": "string", "ar": "string" }, "boardDesc": { "en": "string", "zh": "string", "ar": "string" } }, "tax": { "total": { "currency": "string", "amount": 0 }, "items": [ { "taxType": "string", "taxName": "string", "amount": { "currency": "string", "amount": 0 }, "desc": "string" } ] } } ] } ] } }

Request

Responses