---
updatedAt: 2026-02-12T05:40:13.000Z
agentTools:
  projectIndex: https://volt-docs.travclan.com/llms.txt
---

# Get Rooms and Rates

This endpoint creates Fetches all rooms and rates for a single selected hotel.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "VoltLite API",
    "description": "### Overview\nLightweight, efficient, and fast — the essence of Volt in minimal form.\n\n### Copyright\n© Copyright 2024, TravClan  \nThis document contains confidential material and is the property and copyright of Travclan.  \nNo part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, chemical, photocopying, recording, or otherwise without the prior written permission of Travclan.",
    "version": "1.1.1",
    "contact": {
      "name": "Volt API Support",
      "url": "https://volt.travclan.com/contact",
      "email": "apisupport@travclan.com"
    }
  },
  "servers": [
    {
      "url": "https://hotel-volt-api-sandbox.travclan.com",
      "description": "Volt Lite SandBox"
    },
    {
      "url": "https://hotel-volt-tp.travclan.com",
      "description": "Volt Lite Production"
    },
    {
      "url": "https://hotel-api-sandbox.travclan.com",
      "description": "Helper API's Sandbox"
    },
    {
      "url": "https://hotels-v1-tp.travclan.com",
      "description": "Helper API's Production"
    }
  ],
  "tags": [
    {
      "name": "Rooms and Rates",
      "description": "APIs related to hotel Rooms and Rates."
    }
  ],
  "paths": {
    "/api/v1/roomsandrates": {
      "post": {
        "operationId": "voltLiteGetRoomsAndRates",
        "tags": [
          "Rooms and Rates"
        ],
        "summary": "Get Rooms and Rates",
        "description": "This endpoint creates Fetches all rooms and rates for a single selected hotel.",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Bearer token for authenticating the request.",
            "example": "Bearer {{access_token}}"
          },
          {
            "name": "source",
            "in": "header",
            "required": true,
            "description": "Specifies the source of the request (End User Source). Available choices: website, android, mweb, ios, mobile.",
            "schema": {
              "type": "string",
              "enum": [
                "website",
                "android",
                "mweb",
                "ios"
              ],
              "default": "website"
            },
            "example": "website"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "traceId": {
                    "type": "string",
                    "description": "The unique identifier for the search session.",
                    "example": "25fda8e8-6daa-4923-8a46-f52042cdfcb3"
                  },
                  "hotelId": {
                    "type": "string",
                    "description": "The unique identifier of the hotel for which the rates and room is required.",
                    "example": "32177510"
                  }
                },
                "required": [
                  "hotelId",
                  "traceId"
                ]
              },
              "example": {
                "traceId": "25fda8e8-6daa-4923-8a46-f52042cdfcb3",
                "hotelId": "39673715"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Get All Roooms and Rates.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Status message of the API response, indicating success or failure."
                    },
                    "error": {
                      "type": "boolean",
                      "description": "Indicates if there was an error with the request (false means no error)."
                    },
                    "code": {
                      "type": "integer",
                      "description": "HTTP status code of the response."
                    },
                    "results": {
                      "type": "object",
                      "description": "Contains the main data of the API response.",
                      "properties": {
                        "rooms": {
                          "type": "object",
                          "description": "Details of the rooms.",
                          "additionalProperties": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "description": "Unique identifier of the room."
                              },
                              "name": {
                                "type": "string",
                                "description": "Name of the room."
                              },
                              "description": {
                                "type": "string",
                                "description": "Description of the room."
                              },
                              "beds": {
                                "type": "array",
                                "description": "List of bed details.",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "description": "Type of bed (e.g., KingBed)."
                                    },
                                    "count": {
                                      "type": "string",
                                      "description": "Number of beds."
                                    }
                                  }
                                }
                              },
                              "smokingAllowed": {
                                "type": "boolean",
                                "description": "Indicates if smoking is allowed in the room."
                              },
                              "facilities": {
                                "type": "array",
                                "description": "List of room facilities.",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string",
                                      "description": "Name of the facility."
                                    }
                                  }
                                }
                              },
                              "views": {
                                "type": "array",
                                "description": "List of views available from the room.",
                                "items": {
                                  "type": "string"
                                }
                              }
                            }
                          }
                        },
                        "options": {
                          "type": "object",
                          "description": "Options for room rates.",
                          "properties": {
                            "rate": {
                              "type": "object",
                              "description": "Details of the room rates.",
                              "properties": {
                                "policies": {
                                  "type": "array",
                                  "description": "List of policies related to the room rate.",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "description": "Type of policy (e.g., Check-in, Check-out, Cancellation)."
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "Description of the policy."
                                      }
                                    }
                                  }
                                },
                                "boardBasis": {
                                  "type": "object",
                                  "description": "Details about the board basis (e.g., Room Only, Bed & Breakfast).",
                                  "properties": {
                                    "description": {
                                      "type": "string",
                                      "description": "Description of the board basis."
                                    },
                                    "type": {
                                      "type": "string",
                                      "description": "Type of board basis (e.g., RoomOnly, FullBoard)."
                                    }
                                  }
                                },
                                "finalRate": {
                                  "type": "number",
                                  "description": "finalRate - Net price of this rate after all calculations."
                                },
                                "availability": {
                                  "type": "string",
                                  "description": "Number of rooms available."
                                },
                                "needsPriceCheck": {
                                  "type": "boolean",
                                  "description": "Indicates whether the price needs to be revalidated before booking."
                                },
                                "isPackageRate": {
                                  "type": "boolean",
                                  "description": "Specifies if the rate is part of a package (e.g., hotel + flight)."
                                },
                                "occupancies": {
                                  "type": "array",
                                  "description": "List of occupancy configurations for the room.",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "roomId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "description": "Unique identifier for the specific room."
                                      },
                                      "stdRoomId": {
                                        "type": "string",
                                        "description": "Standard room identifier."
                                      },
                                      "numOfAdults": {
                                        "type": "string",
                                        "description": "Number of adult occupants."
                                      },
                                      "numOfChildren": {
                                        "type": "string",
                                        "description": "Number of children occupants."
                                      }
                                    }
                                  }
                                },
                                "currency": {
                                  "type": "string",
                                  "description": "Currency code for the room price (e.g., INR)."
                                },
                                "refundable": {
                                  "type": "boolean",
                                  "description": "Indicates if the booking is refundable."
                                },
                                "refundability": {
                                  "type": "string",
                                  "description": "Text label indicating refund policy (e.g., NonRefundable, Refundable)."
                                },
                                "allGuestsInfoRequired": {
                                  "type": "boolean",
                                  "description": "Indicates if full guest information is mandatory at the time of booking."
                                },
                                "cancellationPolicies": {
                                  "type": "array",
                                  "description": "List of applicable cancellation policies.",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "estimatedValue": {
                                        "type": "integer",
                                        "description": "Monetary value (likely penalty) if cancellation occurs."
                                      },
                                      "start": {
                                        "type": "string",
                                        "format": "date-time",
                                        "description": "Start date-time of the cancellation policy in ISO 8601 format."
                                      },
                                      "end": {
                                        "type": "string",
                                        "format": "date-time",
                                        "description": "End date-time of the cancellation policy in ISO 8601 format."
                                      }
                                    }
                                  }
                                },
                                "isPassportMandatory": {
                                  "type": "boolean",
                                  "description": "Indicates if a passport is required for booking."
                                },
                                "isPANMandatory": {
                                  "type": "boolean",
                                  "description": "Indicates if a PAN card is required for booking."
                                },
                                "providerHotelId": {
                                  "type": "string",
                                  "description": "ID of the hotel from the provider's system."
                                }
                              }
                            }
                          }
                        },
                        "standardizedRooms": {
                          "type": "object",
                          "description": "Details about standardized rooms.",
                          "additionalProperties": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "description": "Unique identifier for the standardized room."
                              },
                              "name": {
                                "type": "string",
                                "description": "Name of the standardized room."
                              },
                              "images": {
                                "type": "array",
                                "description": "List of images for the room.",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "links": {
                                      "type": "array",
                                      "description": "List of image links.",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "description": "URL of the image."
                                          },
                                          "size": {
                                            "type": "string",
                                            "description": "Size of the image (e.g., Standard, Xxl)."
                                          }
                                        }
                                      }
                                    },
                                    "caption": {
                                      "type": "string",
                                      "description": "Caption for the image."
                                    }
                                  }
                                }
                              },
                              "facilities": {
                                "type": "array",
                                "description": "List of facilities available in the room.",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string",
                                      "description": "Name of the facility."
                                    }
                                  }
                                }
                              },
                              "maxGuestAllowed": {
                                "type": "string",
                                "description": "Maximum number of guests allowed in the room."
                              },
                              "maxAdultAllowed": {
                                "type": "string",
                                "description": "Maximum number of adults allowed in the room."
                              },
                              "maxChildrenAllowed": {
                                "type": "string",
                                "description": "Maximum number of children allowed in the room."
                              },
                              "area": {
                                "type": "object",
                                "description": "Area details of the room.",
                                "properties": {
                                  "squareFeet": {
                                    "type": "string",
                                    "description": "Area in square feet."
                                  }
                                }
                              },
                              "views": {
                                "type": "array",
                                "description": "List of views available from the room.",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "type": {
                                "type": "string",
                                "description": "Type of the room."
                              },
                              "beds": {
                                "type": "array",
                                "description": "Details about the beds in the room.",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "description": "Type of the bed (e.g., KingBed)."
                                    },
                                    "count": {
                                      "type": "string",
                                      "description": "Number of beds."
                                    }
                                  }
                                }
                              },
                              "mappedRoomRates": {
                                "type": "array",
                                "description": "List of room rates mapped to the standardized room.",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "rateId": {
                                      "type": "string",
                                      "description": "Unique identifier for the room rate."
                                    },
                                    "roomId": {
                                      "type": "string",
                                      "description": "Unique identifier for the room."
                                    },
                                    "occupancies": {
                                      "type": "array",
                                      "description": "Details about room occupancy.",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "numOfAdults": {
                                            "type": "integer",
                                            "description": "Number of adults for the room."
                                          },
                                          "numOfChildren": {
                                            "type": "integer",
                                            "description": "Number of children for the room."
                                          },
                                          "childAges": {
                                            "type": "array",
                                            "description": "Ages of children staying in the room.",
                                            "items": {
                                              "type": "integer"
                                            }
                                          }
                                        }
                                      }
                                    },
                                    "rateAmount": {
                                      "type": "number",
                                      "description": "Rate amount for the room."
                                    },
                                    "currency": {
                                      "type": "string",
                                      "description": "Currency code for the rate amount."
                                    }
                                  }
                                }
                              },
                              "attributes": {
                                "type": "array",
                                "description": "Additional attributes for the room.",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "type": "string",
                                      "description": "Attribute key."
                                    },
                                    "value": {
                                      "type": "string",
                                      "description": "Attribute value."
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "message": "OK",
                  "error": false,
                  "code": 200,
                  "results": {
                    "options": {
                      "b86182d5-3cc9-46b8-a0e6-1abe8f479b99": {
                        "rate": {
                          "availability": "3",
                          "needsPriceCheck": true,
                          "isPackageRate": false,
                          "occupancies": [
                            {
                              "roomId": "ede7f7a5-81ae-4499-9a26-eb2777b9f56f",
                              "stdRoomId": "11",
                              "numOfAdults": "2",
                              "numOfChildren": "0"
                            },
                            {
                              "roomId": "ede7f7a5-81ae-4499-9a26-eb2777b9f56f",
                              "stdRoomId": "11",
                              "numOfAdults": "2",
                              "numOfChildren": "0"
                            },
                            {
                              "roomId": "ede7f7a5-81ae-4499-9a26-eb2777b9f56f",
                              "stdRoomId": "11",
                              "numOfAdults": "1",
                              "numOfChildren": "0"
                            }
                          ],
                          "currency": "INR",
                          "refundable": false,
                          "refundability": "NonRefundable",
                          "allGuestsInfoRequired": false,
                          "boardBasis": {
                            "description": "ROOM ONLY",
                            "type": "RoomOnly"
                          },
                          "cancellationPolicies": [
                            {
                              "estimatedValue": 21916,
                              "start": "2025-05-17T21:59:00+05:30",
                              "end": "2025-05-25T00:00:00+00:00"
                            }
                          ],
                          "IsPassportMandatory": false,
                          "IsPANMandatory": true,
                          "providerHotelId": "467726",
                          "policies": [
                            {
                              "type": "Extra Guest Info",
                              "text": "We don't guarantee an Extra Bed for Extra guests, it is subject to availability of the hotel and may be chargeable as well."
                            },
                            {
                              "type": "Extra Guest Info",
                              "text": "We don't guarantee an Extra Bed for Extra guests, it is subject to availability of the hotel and may be chargeable as well."
                            }
                          ],
                          "finalRate": 21916
                        }
                      }
                    },
                    "rooms": {
                      "ede7f7a5-81ae-4499-9a26-eb2777b9f56f": {
                        "id": "ede7f7a5-81ae-4499-9a26-eb2777b9f56f",
                        "name": "Room RUN OF HOUSE",
                        "description": "Room RUN OF HOUSE",
                        "beds": [],
                        "smokingAllowed": false,
                        "facilities": [],
                        "views": []
                      }
                    },
                    "standardizedRooms": {
                      "1": {
                        "id": "1",
                        "name": "Junior Suite King Bed",
                        "images": [
                          {
                            "caption": "Room",
                            "links": [
                              {
                                "url": "https://i.travelapi.com/lodging/12000000/11550000/11544400/11544400/65adfcb3_b.jpg",
                                "size": "Standard"
                              },
                              {
                                "url": "https://i.travelapi.com/lodging/12000000/11550000/11544400/11544400/65adfcb3_t.jpg",
                                "size": "Xs"
                              },
                              {
                                "url": "https://i.travelapi.com/lodging/12000000/11550000/11544400/11544400/65adfcb3_z.jpg",
                                "size": "Xxl"
                              }
                            ]
                          },
                          {
                            "caption": "Room",
                            "links": [
                              {
                                "url": "https://i.travelapi.com/lodging/12000000/11550000/11544400/11544400/6da5ef0a_b.jpg",
                                "size": "Standard"
                              },
                              {
                                "url": "https://i.travelapi.com/lodging/12000000/11550000/11544400/11544400/6da5ef0a_t.jpg",
                                "size": "Xs"
                              },
                              {
                                "url": "https://i.travelapi.com/lodging/12000000/11550000/11544400/11544400/6da5ef0a_z.jpg",
                                "size": "Xxl"
                              }
                            ]
                          }
                        ],
                        "facilities": [
                          {
                            "name": "Non-Smoking"
                          },
                          {
                            "name": "Club level room"
                          },
                          {
                            "name": "Television"
                          },
                          {
                            "name": "Turndown service"
                          },
                          {
                            "name": "Premium bedding"
                          }
                        ],
                        "maxGuestAllowed": "5",
                        "maxAdultAllowed": "3",
                        "maxChildrenAllowed": "2",
                        "area": {
                          "squareFeet": "800"
                        },
                        "views": [
                          "City view",
                          "City view"
                        ],
                        "type": "Junior Suite, 1 King Bed",
                        "beds": [
                          {
                            "type": "KingBed",
                            "count": "1"
                          }
                        ],
                        "mappedRoomRates": [],
                        "attributes": []
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request. One or more request parameters are invalid or missing."
          },
          "401": {
            "description": "Unauthorized. Missing or invalid authentication credentials."
          },
          "404": {
            "description": "Not Found. The requested resource could not be located."
          },
          "422": {
            "description": "Bad Request. Client Side Error in Request Body."
          },
          "500": {
            "description": "Internal server error."
          }
        }
      }
    }
  }
}
```