> ## 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.

# Retrieve minimum rate for hotels

> Returns the cheapest rate available for each hotel in the provided list. Ideal for listing pages where you only need to display the starting price for each hotel. All prices are in Rove Miles.



## OpenAPI

````yaml https://api.staging.rovemiles.com/functions/v1/openapi post /hotels/min-rates
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/min-rates:
    post:
      tags:
        - Hotels
      summary: Retrieve minimum rate for hotels
      description: >-
        Returns the cheapest rate available for each hotel in the provided list.
        Ideal for listing pages where you only need to display the starting
        price for each hotel. All prices are in Rove Miles.
      operationId: getHotelMinRates
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - hotelIds
                - checkin
                - checkout
                - occupancies
              properties:
                hotelIds:
                  type: array
                  description: >-
                    Array of hotel IDs to get minimum rates for. These IDs come
                    from the /hotels/list endpoint.
                  items:
                    type: string
                  minItems: 1
                  maxItems: 5000
                  example:
                    - hotel123
                    - hotel456
                    - hotel789
                checkin:
                  type: string
                  format: date
                  description: Check-in date (YYYY-MM-DD)
                  example: '2023-12-15'
                checkout:
                  type: string
                  format: date
                  description: Check-out date (YYYY-MM-DD)
                  example: '2023-12-20'
                occupancies:
                  type: array
                  description: Occupancy details for each room
                  items:
                    type: object
                    required:
                      - adults
                    properties:
                      adults:
                        type: integer
                        description: Number of adults in the room
                        minimum: 1
                        maximum: 9
                      children:
                        type: array
                        description: Ages of children in the room
                        items:
                          type: integer
                          minimum: 0
                          maximum: 17
                  example:
                    - adults: 2
                      children:
                        - 5
                        - 9
                guestNationality:
                  type: string
                  description: Guest nationality in ISO 2-letter country code format
                  pattern: ^[A-Z]{2}$
                  example: US
      responses:
        '200':
          description: Successfully retrieved minimum hotel rates
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HotelMinRateList'
              example:
                data:
                  - hotelId: RM42853
                    minRate:
                      amount: 29500
                      originalAmount: 295
                      originalCurrency: USD
                      roomName: Deluxe King Room
                      boardType: RO
                      boardName: Room Only
                      refundable: true
                  - hotelId: RM36721
                    minRate:
                      amount: 18750
                      originalAmount: 187.5
                      originalCurrency: USD
                      roomName: Studio Suite
                      boardType: BB
                      boardName: Bed & Breakfast
                      refundable: true
                  - hotelId: RM51908
                    minRate:
                      amount: 12500
                      originalAmount: 125
                      originalCurrency: USD
                      roomName: Standard Queen Room
                      boardType: BB
                      boardName: Bed & Breakfast
                      refundable: false
                sandbox: false
        '204':
          description: No Content - No rates available for the requested hotels
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    HotelMinRateList:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            properties:
              hotelId:
                type: string
                description: Unique identifier of the hotel
              minRate:
                type: object
                properties:
                  amount:
                    type: integer
                    description: Price in Rove Miles for the cheapest available room
                  originalAmount:
                    type: number
                    format: float
                    description: >-
                      Original price in the source currency before conversion to
                      miles
                  originalCurrency:
                    type: string
                    description: Currency code of the original price
                  roomName:
                    type: string
                    description: Name of the cheapest room type
                  boardType:
                    type: string
                    description: Board type code (e.g., RO, BB, HB, FB)
                  boardName:
                    type: string
                    description: >-
                      Full name of the board type (e.g., Room Only, Bed &
                      Breakfast)
                  refundable:
                    type: boolean
                    description: Whether this rate is refundable
        sandbox:
          type: boolean
          description: Indicates if the request was processed in sandbox mode
    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'

````