> ## 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 top hotel deals

> Returns the best hotel deals near the user's location. All prices are in Rove Miles.



## OpenAPI

````yaml https://api.staging.rovemiles.com/functions/v1/openapi get /hotels/deals
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/deals:
    get:
      tags:
        - Deals
      summary: Get top hotel deals
      description: >-
        Returns the best hotel deals near the user's location. All prices are in
        Rove Miles.
      parameters:
        - name: sort
          in: query
          required: true
          schema:
            type: string
            enum:
              - cpm
              - multiplier
          description: >-
            Sorting method for the deals. Use 'cpm' for cost per mile or
            'multiplier' for the highest multiplier.
      responses:
        '200':
          description: Successfully retrieved hotel deals
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HotelDeals'
              example:
                data:
                  - data:
                      hotel:
                        id: lp1f982
                        name: SAHARA Las Vegas
                        hotel_description: >-
                          <p><strong>Luxurious Amenities</strong><br>Indulge in
                          the expansive outdoor pools, gourmet dining options,
                          and rejuvenating spa services at SAHARA Las Vegas.
                          Relax and unwind in style with the free WiFi provided
                          throughout the property.</p><p><strong>Stunning
                          Views</strong><br>Take in the breathtaking views of
                          the surrounding area from the terrace of SAHARA Las
                          Vegas. Immerse yourself in the vibrant energy of the
                          city while enjoying the convenience of a casino and
                          on-site shops.</p><p><strong>Culinary
                          Delights</strong><br>Experience a culinary journey
                          like no other at the Bazaar restaurant, where Spanish
                          flavors meet contemporary techniques to create
                          unforgettable dishes. From exquisite dining to
                          convenient free parking, every aspect of your stay is
                          designed to exceed your expectations.</p><p>Book now
                          to experience the ultimate blend of luxury and
                          excitement at SAHARA Las Vegas.</p>
                        address: 2535 Las Vegas Blvd S
                        main_photo: https://static.cupid.travel/hotels/432614912.jpg
                        thumbnail: >-
                          https://static.cupid.travel/hotels/thumbnail/432614912.jpg
                        stars: 4
                        rating: 7.9
                        review_count: 11197
                        facilities:
                          - name: Non-smoking rooms
                          - name: Air conditioning
                          - name: Swimming pool
                        latitude: 36.14298
                        longitude: -115.15842
                        country: us
                        city: Las Vegas
                        zip: '89109'
                      room_types:
                        - room_type_id: >-
                            GY2TSLJRGI4TIMJQPRHFERSOPQZDAMRUGA2TAMZRGAYDA7BRPRJDCNJZGJ6DMNBTGI
                          offer_id: >-
                            GE5ESNKNKZKVEQ2OJRDE4RSPKIZEMR2OIRKVOVCTKNFVERCWKNLUWVKJKZDVKRKWGJH
                          rates:
                            - rate_id: >-
                                KWK2KNCEWTRWIRBU4WSVI5KVUVCHJZJFUR2FGNKEGTSSKRFUEUSYI5MVURCHIVNEIU2OIJJE
                              occupancy_number: 1
                              name: Blanca King
                              max_occupancy: 1
                              adult_count: 1
                              child_count: 0
                              board_type: RO
                              board_name: Room Only
                              remarks: ''
                              cancellation_policies:
                                cancel_policy_infos:
                                  - amount: 64.31
                                    currency: USD
                                    cancel_time: '2024-05-03T10:00:00.000Z'
                                    type: amount
                                    timezone: GMT
                                hotel_remarks: []
                                refundable_tag: NRFN
                          calculations:
                            excluded_taxes: 62.3
                            price_per_night:
                              amount: 109.94
                              currency: USD
                            selling_price:
                              amount: 117.23655000000001
                              currency: USD
                            miles_earning:
                              miles_earned: 3874
                              multiplier: 33
                            miles_required: 5000
                            cpm: 2.34
                    end_date: '2025-09-17'
                    place_id: ChIJ0X31pIK3voARo3mz1ebVzDo
                    start_date: '2025-09-16'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    HotelDeals:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            properties:
              data:
                type: object
                properties:
                  hotel:
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                      hotel_description:
                        type: string
                      address:
                        type: string
                      main_photo:
                        type: string
                        format: uri
                      thumbnail:
                        type: string
                        format: uri
                      stars:
                        type: integer
                      rating:
                        type: number
                      review_count:
                        type: integer
                      facilities:
                        type: array
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                      latitude:
                        type: number
                      longitude:
                        type: number
                      country:
                        type: string
                      city:
                        type: string
                      zip:
                        type: string
                  room_types:
                    type: array
                    items:
                      type: object
                      properties:
                        room_type_id:
                          type: string
                        offer_id:
                          type: string
                        rates:
                          type: array
                          items:
                            type: object
                            properties:
                              rate_id:
                                type: string
                              occupancy_number:
                                type: integer
                              name:
                                type: string
                              max_occupancy:
                                type: integer
                              adult_count:
                                type: integer
                              child_count:
                                type: integer
                              board_type:
                                type: string
                              board_name:
                                type: string
                              remarks:
                                type: string
                              cancellation_policies:
                                type: object
                                properties:
                                  cancel_policy_infos:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        amount:
                                          type: number
                                        currency:
                                          type: string
                                        cancel_time:
                                          type: string
                                          format: date-time
                                        type:
                                          type: string
                                        timezone:
                                          type: string
                                  hotel_remarks:
                                    type: array
                                    items:
                                      type: string
                                  refundable_tag:
                                    type: string
                        calculations:
                          type: object
                          properties:
                            excluded_taxes:
                              type: number
                            price_per_night:
                              type: object
                              properties:
                                amount:
                                  type: number
                                currency:
                                  type: string
                            selling_price:
                              type: object
                              properties:
                                amount:
                                  type: number
                                currency:
                                  type: string
                            miles_earning:
                              type: object
                              properties:
                                miles_earned:
                                  type: integer
                                multiplier:
                                  type: number
                            miles_required:
                              type: integer
                            cpm:
                              type: number
              end_date:
                type: string
                format: date
              place_id:
                type: string
              start_date:
                type: string
                format: date
    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
    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'

````