> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rovemiles.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get the details of a hotel

> Returns detailed information about a specific hotel, including amenities, policies, and images.



## OpenAPI

````yaml https://api.staging.rovemiles.com/functions/v1/openapi get /hotels/{id}
openapi: 3.0.3
info:
  title: Rove Miles API
  version: 0.1.0
  description: Data Utils, Flights, Hotels & Miles endpoints.
servers:
  - url: https://api.staging.rovemiles.com/functions/v1
security:
  - bearerAuth: []
tags:
  - name: Data
    description: Operations related to reference data like airports and places
  - name: Flights
    description: Operations related to flight search and booking
  - name: Hotels
    description: Operations related to hotel search and booking
  - name: Miles
    description: Operations related to miles and points management
  - name: Deals
    description: Operations related to special offers and promotions for flights and hotels
paths:
  /hotels/{id}:
    get:
      tags:
        - Hotels
      summary: Get the details of a hotel
      description: >-
        Returns detailed information about a specific hotel, including
        amenities, policies, and images.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Unique identifier of the hotel
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HotelDetails'
              example:
                id: RM42853
                name: The Rove Grand Hotel
                description: >-
                  Located in the heart of downtown, The Rove Grand Hotel offers
                  luxury accommodations with stunning city views. This 5-star
                  property features a rooftop pool, full-service spa, and three
                  signature restaurants including our award-winning steakhouse
                  and rooftop cocktail lounge. All rooms feature premium
                  bedding, smart TVs, and marble bathrooms with rainfall
                  showers. Business travelers will appreciate the 24-hour
                  business center, high-speed WiFi, and proximity to the
                  financial district.
                address:
                  line1: 123 Broadway
                  line2: ''
                  city: New York
                  stateProvince: NY
                  postalCode: '10007'
                  countryCode: US
                  countryName: United States
                location:
                  latitude: 40.7128
                  longitude: -74.006
                stars: 5
                amenities:
                  - id: 1
                    name: Free WiFi
                    category: Internet
                  - id: 2
                    name: Swimming Pool
                    category: Facility
                  - id: 3
                    name: Spa
                    category: Wellness
                  - id: 5
                    name: Restaurant
                    category: Food & Drink
                  - id: 8
                    name: Fitness Center
                    category: Wellness
                  - id: 12
                    name: Business Center
                    category: Business
                  - id: 15
                    name: Valet Parking
                    category: Parking
                  - id: 18
                    name: Concierge Service
                    category: Service
                images:
                  - url: https://static.rovemiles.com/hotels/RM42853/exterior1.jpg
                    caption: Hotel Exterior
                    category: exterior
                  - url: https://static.rovemiles.com/hotels/RM42853/lobby1.jpg
                    caption: Grand Lobby
                    category: interior
                  - url: >-
                      https://static.rovemiles.com/hotels/RM42853/deluxe_king1.jpg
                    caption: Deluxe King Room
                    category: room
                  - url: >-
                      https://static.rovemiles.com/hotels/RM42853/exec_suite1.jpg
                    caption: Executive Suite
                    category: room
                  - url: >-
                      https://static.rovemiles.com/hotels/RM42853/restaurant1.jpg
                    caption: Signature Restaurant
                    category: restaurant
                  - url: https://static.rovemiles.com/hotels/RM42853/pool1.jpg
                    caption: Rooftop Pool
                    category: pool
                policies:
                  checkIn:
                    beginTime: '15:00'
                    endTime: '23:00'
                  checkOut:
                    time: '11:00'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    HotelDetails:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the hotel
        name:
          type: string
          description: Name of the hotel
        description:
          type: string
          description: Detailed description of the hotel
        address:
          type: object
          properties:
            line1:
              type: string
            line2:
              type: string
            city:
              type: string
            stateProvince:
              type: string
            postalCode:
              type: string
            countryCode:
              type: string
            countryName:
              type: string
        location:
          type: object
          properties:
            latitude:
              type: number
              format: float
            longitude:
              type: number
              format: float
        stars:
          type: number
          format: float
          description: Hotel star rating (1-5)
        amenities:
          type: array
          items:
            type: object
            properties:
              id:
                type: integer
              name:
                type: string
              category:
                type: string
        images:
          type: array
          items:
            type: object
            properties:
              url:
                type: string
                format: uri
              caption:
                type: string
              category:
                type: string
                enum:
                  - exterior
                  - interior
                  - room
                  - restaurant
                  - pool
                  - other
        policies:
          type: object
          properties:
            checkIn:
              type: object
              properties:
                beginTime:
                  type: string
                  format: time
                endTime:
                  type: string
                  format: time
            checkOut:
              type: object
              properties:
                time:
                  type: string
                  format: time
    Error:
      type: object
      properties:
        code:
          type: integer
        message:
          type: string
  responses:
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: 400
            message: Bad Request
    Unauthorized:
      description: Unauthorized - Invalid or missing token
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: 401
            message: Unauthorized - Invalid or missing token
    NotFound:
      description: Resource Not Found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: 404
            message: The requested resource was not found
    InternalError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: 500
            message: Internal Server Error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        API key for authentication. Add your API key to the Authorization header
        with this format: 'Bearer your_api_key_here'

````