--- title: "Get the details of a hotel" method: GET path: "/data/hotel" tags: ["Hotels"] --- # Get the details of a hotel `GET /data/hotel` ## Request - Base URL: `https://api.liteapi.travel/v3.0` - URL: `https://api.liteapi.travel/v3.0/data/hotel` - Auth: API key in header `X-API-Key` ## Overview Get comprehensive details about a specific hotel including descriptions, amenities, images, location, and ratings. Perfect for displaying hotel detail pages. ## When to Use - **Hotel detail pages** - Show complete hotel information - **Booking pages** - Display hotel details before booking - **Hotel profiles** - Build rich hotel information pages - **Content display** - Show descriptions, amenities, and images ## What You Get - **Complete hotel information** - Name, address, description, and ratings - **Amenities list** - All available facilities and services - **Image gallery** - Hotel photos and images - **Location details** - Address, coordinates, and location information - **Hotel metadata** - Star rating, chain information, and classifications ## Quick Start Provide the `hotelId` as a query parameter. Returns complete hotel details including all metadata, amenities, and images. ## Query parameters - `hotelId` string, required - `timeout` number, float - `language` string - `advancedAccessibilityOnly` boolean ## Response `200` OK - object - `data` object - `id` string, required: Unique identifier for the hotel. - `name` string, required: Name of the hotel. - `hotelDescription` string: Detailed description of the hotel. - `markdownDescription` string: Detailed description of the hotel, formatted as Markdown. - `normalizedDescription` string: Normalized plain-text description of the hotel. - `hotelImportantInformation` string: Critical information and important details about the hotel. - `connectivityType` 'Pull' | 'Pull&Push': How the property is connected: `Pull&Push` for Cloud properties connected as Push+Pull, `Pull` otherwise. - `securityDeposit` object: The refundable deposit the property collects from the guest. Only amount, currency and basis are returned. - `amount` number: Deposit amount in the currency given. - `currency` string: ISO 4217 code, e.g. USD. - `basis` string: How the amount is charged, e.g. per_stay or per_night. Absent when not known. - `state` string, nullable: State or province. 2-letter code for the US. - `website` string, nullable: Official website. - `contact` object: Legal and licensing details. - `legalEntity` string, nullable: Legal entity name. - `registrationNumber` string, nullable: Business registration number. - `licenceNumbers` string[], nullable: Licence or permit numbers. - `operatingStatus` object: Whether the property is operating. - `status` 'open' | 'temporarily_closed' | 'permanently_closed' | 'likely_closed' | 'unknown' | 'null', nullable: Status. - `checkedAt` string, date-time, nullable: When the status was checked. - `policyAttributes` object: Typed hotel policies and facility flags. Every boolean is true, false or null. null means not stated. Flags derived from the facility list are false when the facility is absent; all flags are null when the hotel has no facilities. - `checkIn` object: Check-in window, HH:MM. - `from` string, nullable: Earliest check-in. - `until` string, nullable: Latest check-in. - `checkOut` object: Check-out, HH:MM. - `until` string, nullable: Latest check-out. - `minimumCheckInAge` integer, nullable: Minimum age to check in. - `saleCutoff` object: Latest time a booking can be made. - `time` string, nullable: HH:MM. - `daysBefore` integer, nullable: Days before arrival. - `children` object: Children policy. - `allowed` boolean, nullable: Children allowed. - `infantsAllowed` boolean, nullable: Infants allowed. - `cribAvailable` boolean, nullable: Crib or cot available. - `cribFee` number, nullable: Crib fee, 0 when free. - `cribAgeMax` integer, nullable: Maximum age for a crib. - `pets` object: Pet policy. - `allowed` boolean, nullable: Pets allowed. - `fee` boolean, nullable: A pet fee applies. - `feeAmount` number, nullable: Pet fee amount. - `feeCurrency` string, nullable: ISO 4217 code. - `feeBasis` string, nullable: How the fee is charged. - `weightLimitLb` number, nullable: Weight limit in pounds. - `feeRefundable` boolean, nullable: Fee is refundable. - `terms` string, nullable: Pet policy text. - `deposit` object: Security deposit. - `required` boolean, nullable: Deposit is required. - `amount` number, nullable: Amount. - `currency` string, nullable: ISO 4217 code. - `basis` string, nullable: per_stay or per_night. - `collectedAt` string, nullable: When it is collected, e.g. checkin. - `refundedAt` string, nullable: When it is refunded, e.g. checkout. - `method` string, nullable: How it is collected, e.g. credit_card. - `payment` object: Payment methods at the property. - `cardsAccepted` boolean, nullable: Cards accepted. - `cashAccepted` boolean, nullable: Cash accepted. - `wifi` object: WiFi. - `inRoom` boolean, nullable: WiFi in guest rooms. - `free` boolean, nullable: WiFi is free. - `feeAmount` number, nullable: WiFi fee. - `feePeriod` string, nullable: per_night, per_stay or per_hour. - `freeInPublicAreas` boolean, nullable: Free WiFi in public areas. - `parking` object: Parking. - `selfParking` boolean, nullable: Self parking available. - `free` boolean, nullable: Parking is free. - `chargeMode` 'free' | 'per_day' | 'per_hour' | 'charges_may_apply' | 'charges_apply' | 'null', nullable: Charge mode. - `feeAmount` number, nullable: Parking fee. - `feePeriod` string, nullable: per_night, per_stay or per_hour. - `location` 'on_site' | 'offsite' | 'null', nullable: Parking location. - `reservationRequired` boolean, nullable: Reservation needed. - `valet` boolean, nullable: Valet parking. - `evCharger` boolean, nullable: Electric vehicle charging. - `facilities` object: Facility flags. - `nonSmokingProperty` boolean, nullable: Whole property is non-smoking. - `elevator` boolean, nullable: Elevator. - `fitnessCenter` boolean, nullable: Fitness center. - `fitnessOpen24h` boolean, nullable: Fitness center open 24 hours. - `pool` boolean, nullable: Pool. - `poolType` string, nullable: indoor, outdoor or indoor_and_outdoor. - `poolCurrentlyClosed` boolean, nullable: Pool closed today. - `hotTub` boolean, nullable: Hot tub. - `spaServices` boolean, nullable: Spa services. - `sauna` boolean, nullable: Sauna. - `saunaCurrentlyClosed` boolean, nullable: Sauna closed today. - `foodAndDrink` object: Food and drink. - `bar` boolean, nullable: Bar on property. - `restaurant` boolean, nullable: Restaurant on property. - `restaurantNames` string[], nullable: Restaurant names. - `roomService` boolean, nullable: Room service. - `breakfastAvailable` boolean, nullable: Breakfast available. - `breakfastIncluded` boolean, nullable: Breakfast included. - `breakfastPrice` object: Breakfast price. - `amount` number, nullable: Amount. - `currency` string, nullable: ISO 4217 code. - `period` string, nullable: per_night, per_stay or per_hour. - `breakfastType` 'continental' | 'hot' | 'buffet' | 'american' | 'other' | 'null', nullable: Breakfast type. - `renovation` object: Renovation. - `underway` boolean, nullable: Renovation underway. - `notes` string, nullable: Renovation notes. - `resortFee` object: Resort fee. - `amount` number, nullable: Amount. - `currency` string, nullable: ISO 4217 code. - `period` string, nullable: per_night, per_stay or per_hour. - `cancellationTerms` string, nullable: Property cancellation terms. - `houseRules` string[], nullable: House rules. - `facilityClosures` object[], nullable: Facility closures with ISO dates. - `facility` string - `from` string, date - `until` string, date - `roomAmenitiesAllRooms` object: Room amenities true only when every room has them; false when a room states it lacks them. - `television` boolean, nullable: TV in the room. - `televisionSize` string, nullable: TV size, e.g. 40-inch. - `airConditioner` boolean, nullable: Air conditioning. - `hairDryer` boolean, nullable: Hair dryer. - `iron` boolean, nullable: Iron or ironing facilities. - `hangers` boolean, nullable: Hangers. - `coffeeMaker` boolean, nullable: Coffee or tea maker. - `crib` boolean, nullable: Crib or cot available. - `laptopFriendlyWorkplace` boolean, nullable: Desk or laptop-friendly workspace. - `kitchen` boolean, nullable: Kitchen or kitchenette. - `smokeDetector` boolean, nullable: Smoke detector. - `carbonMonoxideDetector` boolean, nullable: Carbon monoxide detector. - `checkinCheckoutTimes` object: Check-in and check-out timing details for the hotel. - `checkout` string: Standard check-out time for guests. - `checkin_start` string: Earliest time a guest can check in. - `checkin_end` string: Latest time a guest can check in. - `instructions` object[]: Check-in and check-out instructions, always returned as an array of objects. - `id` integer: Identifier of the instruction, when available. - `instruction` string, required: Check-in or check-out instruction text. - `special_instructions` string: Special instructions for check-in and check-out. - `hotelImages` object[]: List of images representing the hotel. - `url` string: URL of the hotel image. - `urlHd` string: High definition URL of the hotel image. - `caption` string: Caption or description for the image. - `order` integer: Display order of the image. - `defaultImage` boolean: Indicates if this image is the default for the hotel. - `main_photo` string: URL of the main photo for the hotel. - `thumbnail` string: URL of the hotel's thumbnail image. - `videoUrl` string: URL of the hotel's video. - `country` string: Country where the hotel is located. - `city` string: City where the hotel is located. - `starRating` integer: Star rating of the hotel. - `location` object: Geographical coordinates of the hotel. - `latitude` number: Latitude coordinate of the hotel. - `longitude` number: Longitude coordinate of the hotel. - `address` string: Physical address of the hotel. - `hotelFacilities` string[]: List of facilities offered by the hotel. - `chain` string: Name of the hotel chain, if applicable. - `facilities` object[]: Detailed list of facilities provided by the hotel. - `facilityId` integer: Unique identifier for the facility. - `name` string: Name of the facility. - `rooms` object[]: List of room objects available in the hotel. - `id` integer: Unique identifier for the room. - `roomName` string: Name or type designation of the room. - `roomTitle` string: Display title of the room. - `description` string: Detailed description of the room and its features. - `markdownDescription` string: Description of the room and its features, formatted as Markdown. - `normalizedDescription` string: Normalized plain-text description of the room and its features. - `roomSizeSquare` number: Size of the room in square meters. - `roomSizeUnit` string: Unit of measurement for room size (e.g., 'm2'). - `hotelId` string: Identifier of the hotel this room belongs to. - `maxAdults` integer: Maximum number of adults that can be accommodated. - `maxChildren` integer: Maximum number of children that can be accommodated. - `maxOccupancy` integer: Overall maximum occupancy of the room. - `officialSiteRoomName` string, nullable: Room name as shown on the property's own website. Not for display as a title. - `attributes` object: Room amenity flags. Every boolean is true, false or null. null means not stated. false only when the room states it lacks the amenity. - `television` boolean, nullable: TV in the room. - `televisionSize` string, nullable: TV size, e.g. 40-inch. - `airConditioner` boolean, nullable: Air conditioning. - `hairDryer` boolean, nullable: Hair dryer. - `iron` boolean, nullable: Iron or ironing facilities. - `hangers` boolean, nullable: Hangers. - `coffeeMaker` boolean, nullable: Coffee or tea maker. - `crib` boolean, nullable: Crib or cot available. - `laptopFriendlyWorkplace` boolean, nullable: Desk or laptop-friendly workspace. - `kitchen` boolean, nullable: Kitchen or kitchenette. - `smokeDetector` boolean, nullable: Smoke detector. - `carbonMonoxideDetector` boolean, nullable: Carbon monoxide detector. - `ranking` integer, nullable: Popularity rank of the room, from 1 (low) to 5 (high). null when the room isn't ranked. - `bedTypes` object[]: List of bed configurations available in the room. - `quantity` integer: Number of beds of this type available in the room. - `bedType` string: Type of the bed (e.g., 'King size', 'Double bed'). - `bedSize` string: Dimensions or size description of the bed. - `Id` integer: Unique identifier for the bed type. - `roomAmenities` object[]: List of amenities provided in the room. - `amenitiesId` integer: Unique identifier for the amenity. - `name` string: Name of the amenity. - `sort` integer: Sort order for displaying the amenity. - `photos` object[]: List of photos associated with the room. - `url` string: URL of the room photo. - `imageDescription` string: Description or caption for the photo. - `imageClass1` string: Additional classification or tag for the image. - `imageClass2` string: Secondary classification or tag for the image. - `failoverPhoto` string: Backup URL for the photo in case the primary URL fails. - `mainPhoto` boolean: Indicates if this is the main photo for the room. - `score` number: Relevance score or ranking for the photo. - `classId` integer: Identifier for the photo's classification. - `classOrder` integer: Order of appearance for the photo based on its classification. - `hd_url` string: High definition URL of the room photo. - `bedRelation` 'NONE' | 'AND' | 'OR' | 'COMPLEX': How the entries in `bedTypes` relate to one another. - `NONE` - no relation applies, the room has a single bed configuration (or none is published). - `AND` - every listed bed is present in the room at the same time, e.g. a King **and** a sofa bed. - `OR` - the listed beds are alternatives, the room is made up with one of them, e.g. a King **or** two Queens. - `COMPLEX` - the setup does not reduce to a single `AND` or `OR`, e.g. a King **or** two Queens, **and** a sofa bed. - `accessibility` object: Accessibility information and certifications for the hotel. - `certificateId` string: Identifier for the accessibility certificate. - `certificateUrl` string: URL where the accessibility certificate can be viewed. - `certificateHtml` string: HTML content of the accessibility certificate. - `attributes` object: Detailed accessibility attributes for various areas of the hotel. - `publicArea` object: Accessibility details for public areas. - `hillLocated` boolean: Indicates if the public area is located on a hill. - `isRamp` boolean: Indicates if a ramp is available in the public area. - `rampAngle` number: Angle of the ramp in the public area. - `rampLength` number: Length of the ramp in the public area. - `entranceType` string: Type of entrance provided in the public area. - `entranceDoorWidth` number: Width of the entrance door. - `entranceLeveled` boolean: Indicates if the entrance is level with the ground. - `distanceFromTheElevatorToTheAccessibleRoom` number: Distance between the elevator and an accessible room. - `roomMaxGuestsNumber` integer: Maximum number of guests allowed in an accessible room. - `petFriendly` string: Indicates if the accessible area is pet-friendly. - `receptionAndRestaurant` object: Accessibility details for the reception and restaurant areas. - `receptionHearingAccessible` boolean: Indicates if the reception area is accessible for the hearing impaired. - `receptionWheelchairAccessible` boolean: Indicates if the reception area is wheelchair accessible. - `restaurantWheelchairAccessible` boolean: Indicates if the restaurant is wheelchair accessible. - `elevator` object: Accessibility features for elevators. - `elevatorAudioSignals` boolean: Indicates if the elevator has audio signals. - `elevatorBrailleNumbers` boolean: Indicates if the elevator displays braille numbers. - `elevatorContrastingButtons` boolean: Indicates if the elevator buttons use contrasting colors for visibility. - `elevatorVisualSigns` boolean: Indicates if visual indicators are present in the elevator. - `liftsAccessible` boolean: Indicates if the lifts are accessible to all users. - `room` object: Accessibility features provided within hotel rooms. - `brailleRoomNumbers` boolean: Indicates if room numbers are available in braille. - `noticeableRoomNumber` boolean: Indicates if the room number is prominently displayed. - `roomDoorPeephole` boolean: Indicates if the room door is equipped with a peephole. - `roomKnockSign` boolean: Indicates if there is a knock sign on the room door. - `serviceFromTv` boolean: Indicates if in-room TV service is available. - `hearingKit` boolean: Indicates if a hearing kit is provided in the room. - `tvAlarmClock` boolean: Indicates if the room includes a TV alarm clock. - `accessibleRoomConnectingDoors` boolean: Indicates if accessible rooms have connecting doors. - `ttyHearingSpeechImpaired` boolean: Indicates if the room is equipped with TTY facilities for those who are hearing or speech impaired. - `toiletAndShower` object: Accessibility features for toilet and shower facilities. - `toiletBathroomDoorsIndicator` boolean: Indicates if the bathroom door is clearly marked. - `toiletGrabbingHandles` boolean: Indicates if grabbing handles are available in the toilet area. - `adjustableShowerHead` boolean: Indicates if the shower head is adjustable. - `bathroomBathtub` boolean: Indicates if a bathtub is available in the bathroom. - `bathroomEmergencyCord` boolean: Indicates if an emergency cord is present in the bathroom. - `bathtubGrabbingHandles` boolean: Indicates if the bathtub is equipped with grabbing handles. - `cabinUnderSink` boolean: Indicates if there is a cabinet or storage space under the sink. - `showerChair` string: Specifies the type of shower chair available, if any. - `showerLevelFloor` boolean: Indicates if the shower area has a level floor. - `stairs` object: Accessibility details for staircases. - `isHandrails` boolean: Indicates if handrails are installed on the stairs. - `isStairMarked` boolean: Indicates if the stairs are clearly marked for safety. - `poolAndSpa` object: Accessibility features for pool and spa areas. - `isPoolHandrails` boolean: Indicates if handrails are available in the pool area. - `liftInPool` boolean: Indicates if there is a lift available in the pool. - `spaWheelchairAccessible` boolean: Indicates if the spa area is designed to be wheelchair accessible. - `parking` object: Accessibility details for the parking area. - `parkingWheelchairAccessible` boolean: Indicates if the parking area is accessible for wheelchair users. - `publicToilets` object: Accessibility features for public toilet facilities. - `publicToiletsEmergencyCord` boolean: Indicates if an emergency cord is available in public toilets. - `publicToiletsGrabbingHandles` boolean: Indicates if grabbing handles are provided in public toilets. - `publicToiletsVisualIndicators` boolean: Indicates if visual indicators are present in public toilet facilities. - `totalDisabilityScore` number: Overall score representing the hotel's disability accessibility. - `disabilities` object: Flags indicating specific disability accommodations available at the hotel. - `crouchesCaneImpaired` boolean: Indicates if accommodations are available for individuals using a cane. - `elderlyImpaired` boolean: Indicates if the facility is adapted for the elderly. - `electricWheelchair` boolean: Indicates if electric wheelchair accessibility is provided. - `hearingImpaired` boolean: Indicates if the facility is adapted for those with hearing impairments. - `manualWheelchair` boolean: Indicates if manual wheelchair accessibility is provided. - `visuallyImpaired` boolean: Indicates if accommodations are available for the visually impaired. - `wheelchairOrScooterImpaired` boolean: Indicates if the facility accommodates wheelchair or scooter users. - `disabilityScores` object: Accessibility scores for various disability categories. - `crouchesCaneImpaired` integer: Accessibility score for individuals using a cane. - `elderlyImpaired` integer: Accessibility score for elderly guests. - `electricWheelchair` integer: Accessibility score for electric wheelchair users. - `hearingImpaired` integer: Accessibility score for hearing impaired individuals. - `manualWheelchair` integer: Accessibility score for manual wheelchair users. - `visuallyImpaired` integer: Accessibility score for visually impaired individuals. - `wheelchairOrScooterImpaired` integer: Accessibility score for wheelchair or scooter users. - `phone` string: Contact phone number for the hotel. - `poi` object[]: Points of interest near the hotel with their category, distance in kilometres, and importance. - `name` string: Name of the point of interest. - `category` string: Category of the point of interest. - `distanceKm` number: Distance from the hotel to the point of interest, in kilometres. - `importance` string: Relative importance of the point of interest. - `fax` string: Fax number for the hotel. - `email` string: Contact email address for the hotel. - `hotelType` string: Type or category of the hotel. - `hotelTypeId` number: Identifier for the hotel type. - `chainId` number: Identifier for the hotel chain. - `airportCode` string: IATA code of the nearest airport. - `rating` number: Overall rating of the hotel. - `reviewCount` integer: Total number of reviews received for the hotel. - `rohId` integer: Room of House ID - unique identifier for the hotel property. - `parking` boolean, nullable: Indicates whether parking is available (nullable). - `groupRoomMin` number, nullable: Minimum number of rooms required for group bookings (nullable). - `childAllowed` boolean, nullable: Indicates if children are allowed at the hotel (nullable). - `petsAllowed` boolean, nullable: Indicates if pets are allowed at the hotel (nullable). - `policies` object[]: List of policies and guidelines applicable to the hotel. - `policy_type` string: Specifies the category or classification of the policy. - `name` string: The official title or identifier of the policy, providing a concise summary of its purpose. - `description` string: A comprehensive explanation of the policy, outlining its terms, conditions, and operational details. - `child_allowed` string: Details regarding the hotel's policy on children, including any age restrictions, complimentary services, or special provisions. - `pets_allowed` string: Describes the pet policy, including whether pets are allowed, any applicable restrictions or fees, and specific guidelines for pet owners. - `parking` string: Provides information on parking facilities, including availability, any associated fees, and usage guidelines. - `sentiment_analysis` object: Sentiment analysis data derived from guest reviews. - `cons` string[]: List of negative feedback points from guest reviews. - `pros` string[]: List of positive feedback points from guest reviews. - `categories` object[]: Detailed sentiment analysis categorized by aspects such as cleanliness, service, etc. - `name` string: Name of the sentiment category (e.g., Cleanliness, Service). - `rating` number: Numerical rating for this sentiment category. - `description` string: Detailed description of guest sentiment for this category. - `sentiment_updated_at` string: Timestamp indicating when the sentiment analysis was last updated. - `deletedAt` string: Timestamp indicating when hotel is deleted in our system ## Other responses - `400`: Bad Request - `401`: Unauthorized --- [API](https://skmtc.dev/liteapi/apis/api-hotel-data.md) - [All operations](https://skmtc.dev/liteapi/apis/api-hotel-data/llms.txt) - [OpenAPI document](https://skmtc.dev/liteapi/apis/api-hotel-data/revisions/f89f11b63949?raw)