Traveller's Choice Hotel API
  • 🚩Getting Started with Hotel API
  • πŸ•ΈοΈUnderstanding the API structure
  • πŸ”‘Authentication API
    • Access token
  • πŸ“šHotel Content API
    • Content API
      • Hotels Master
        • Hotels API
        • Hotel detail API
      • Location Master
        • countries
        • States
        • Cities
        • Areas
      • Types Master
        • Room Types Master
          • Room Types API
          • Room Types Detail API
        • Board Type Master
          • Board Types API
          • Board Types Detail API
        • Accommodation Type Master
          • Accommodation Types API
          • Accommodation Type Detail API
        • Chains Master
          • Chains API
          • Chain Detail API
        • Amenities Master
          • Amenities API
          • Amenity Detail API
        • Amenity Group Master
          • Amenity group API
          • Amenity Group Detail API
      • πŸ”„Sync Id
  • 🏨Hotel Booking API
    • Booking API
      • Availability APIs
        • MinRate Availability API
        • Availability API
      • Check Rate API
      • Booking APIs
        • Create a Booking - API
        • Booking Details API
        • Cancel Booking API
  • πŸ•΅οΈTest cases
    • Booking API
  • Webhook
  • Errors
    • Token Error
Powered by GitBook
On this page
  • API details
  • Response details
  1. Hotel Booking API
  2. Booking API
  3. Availability APIs

MinRate Availability API

This API returns the minimum rate for each hotel based on a specific query. You can use this endpoint to retrieve the minimum rates for the list of hotels provided in the request body.

API details

POST /api/v1/hotel/booking-api/availability/rooms/min-rate

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Accept-Encoding

gzip

Body

Name
Type
Description

hotelIds

Array

Hotel ids in array fomat

fromDate

String

checkin date

toDate

String

checkout date

noOfAdults

Integer

No of adults in a room

noOfChildren

Integer

No of children in a room

childrenAges

Array

Age of each children in a room

nationality

String

nationality of the guest

Sample Request
{
    "hotelIds": [100018,100021],
    "fromDate":"2024-10-17",
    "toDate": "2024-10-20",
    "rooms": [
        {
        "noOfAdults": 1,
        "noOfChildren": 0,
        "childrenAges": []
        }
    ],
    "nationality": "UAE"
}

Response details

Response General data

Name
Type
Description

tokenNumber

String

Unique code for an availability request.

fromDate

String

Checkin Date

toDate

String

Check out Date

nationality

String

Guest Nationality ISO code

roomPaxes

Array

roomPaxes.noOfAdults roomPaxes.noOfChildren roomPaxes.childrenAges[]

noOfNights

Integer

Total stay nights

Response Hotel data

Name
Type
Description

hotelId

Integer

Unique Id for the hotel

hotelName

String

Name of the hotel

minPrice

Number

The minimum rate for the hotel based on your query.

Sample Response
{
    "success": true,
    "data": {
        "tokenNumber": "RA_1729202802519",
        "fromDate": "2024-11-17",
        "toDate": "2024-11-19",
        "nationality": "IN",
        "roomPaxes": [
            {
                "noOfAdults": 1,
                "noOfChildren": 0,
                "childrenAges": []
            }
        ],
        "noOfNights": 2,
        "hotels": [
            {
                "hotelId": 100018,
                "hotelName": "Gulf Court Hotel Business Bay",
                "minPrice": 740
            },
            {
                "hotelId": 100021,
                "hotelName": "Hilton Garden Inn Dubai Al Muraqabat",
                "minPrice": 770
            }
        ]
    }
}
PreviousAvailability APIsNextAvailability API

Last updated 7 months ago

🏨