Get room availability
Request to obtain room availability for a specific hotel. Allows specifying the check-in date, number of nights, number of adults, and ages of children.
GET https://[base_url]/v2/bookings/availability?hotel_id={hotel_id}&checkin={checkin}&nights={nights}&children_ages={ages}&adults={adults}
Example:
GET https://[base_url]/v2/bookings/availability?hotel_id=11111&checkin=2024-10-28&nights=3&children_ages=10,14&adults=2
Query parameters
| PARAMETER | TYPE | REQ. | DESCRIPTION |
|---|---|---|---|
| booking_number | Integer | Yes | Integer representing the unique reservation identifier in Roomcloud. Autocore validates against reservation code and CRS ID |
| hotel_id | Integer | Yes | Integer representing the unique identifier of the hotel in Roomcloud |
| checkin | String | Yes | Potential guest check-in date. The format should be YYYY-MM-DD |
| nights | Integer | Yes | Number of nights to reserve. |
| children | String | Yes | Ages of children, separated by commas |
| adults | Integer | Yes | Number of adults |
| room_type | String | No | Room type. Please refer to "Get room types" |
Endpoint response
Status code: 200
{
"total_count": 4,
"adults": 1,
"children_ages": "1",
"available_rooms": [
{
"roomId": "83534",
"roomName": "Habitacion Doble Standard",
"count": 4,
"products": [
{
"roomId": "83534",
"roomName": "Habitacion Doble Standard[Standard]",
"roomType": "DOUBLE",
"rateId": "51491",
"rateDescription": "Double [Flexible - BB]",
"boardType": "BB",
"boardTypeDescription": "ALOJAMIENTO Y DESAYUNO",
"refundable": "partial",
"cancellationPolicy": " The guest can cancel free of charge until 3 days before arrival. If cancelled from 3 days to before arrival, the guest will be charged the first night. If cancelled later or in case of no-show, the guest will be charged the first night. ",
"currency": "COP",
"trm": 3860.92,
"baseDailyAmounts": [
{
"day": "2025-03-01",
"amountAfterTax": 0.0,
"amountBeforeTax": 150000.0,
"amountAfterTaxUSD": 0.0,
"amountBeforeTaxUSD": 38.85
},
{
"day": "2025-03-02",
"amountAfterTax": 0.0,
"amountBeforeTax": 170000.0,
"amountAfterTaxUSD": 0.0,
"amountBeforeTaxUSD": 44.03
}
],
"baseRate": {
"amountBeforeTax": 320000.0,
"amountAfterTax": 380800.0,
"amountBeforeTaxUSD": 82.88,
"amountAfterTaxUSD": 98.63
}
},
{
"roomId": "83534",
"roomName": "Habitacion Doble Standard[No Reembolsable]",
"roomType": "DOUBLE",
"rateId": "55830",
"rateDescription": "Double [Non Refundable - BB]",
"boardType": "BB",
"boardTypeDescription": "ALOJAMIENTO Y DESAYUNO",
"refundable": "none",
"cancellationPolicy": "If cancelled or in case of no-show, the guest will be charged the total price .",
"currency": "COP",
"trm": 3860.92,
"baseDailyAmounts": [
{
"day": "2025-03-01",
"amountAfterTax": 0.0,
"amountBeforeTax": 132000.0,
"amountAfterTaxUSD": 0.0,
"amountBeforeTaxUSD": 34.19
},
{
"day": "2025-03-02",
"amountAfterTax": 0.0,
"amountBeforeTax": 149600.0,
"amountAfterTaxUSD": 0.0,
"amountBeforeTaxUSD": 38.75
}
],
"baseRate": {
"amountBeforeTax": 281600.0,
"amountAfterTax": 335104.0,
"amountBeforeTaxUSD": 72.94,
"amountAfterTaxUSD": 86.79
}
}
]
}
]
}
Status code: 401, 403, 404
{
"code": "Status code",
"message":"Error description",
"detail": "Error details"
}