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": 7,
    "available_rooms": [
        {
            "roomId": "19366",
            "roomName": "HABITACIÓN SUPERIOR",
            "count": 7,
            "products": [
                {
                    "roomId": "19366",
                    "roomName": "HABITACIÓN SUPERIOR[NR]",
                    "roomType": "DOUBLE",
                    "rateId": "12059",
                    "rateDescription": "[NR - HB]",
                    "boardType": "HB",
                    "boardTypeDescription": "MEDIA PENSIÓN",
                    "refundable": "none",
                    "cancellationPolicy": "If cancelled or in case of no-show, the guest will be charged the total price.",
                    "currency": "EUR",
                    "baseDailyAmounts": [
                        {
                            "day": "2024-02-12",
                            "amountBeforeTax": 900.0
                        },
                        {
                            "day": "2024-02-13",
                            "amountBeforeTax": 900.0
                        },
                        {
                            "day": "2024-02-14",
                            "amountBeforeTax": 900.0
                        }
                    ],
                    "baseRate": {
                        "amountBeforeTax": 2700.0,
                        "amountAfterTax": 3213.0
                    }
                },
                {
                    "roomId": "19366",
                    "roomName": "HABITACIÓN SUPERIOR[Standard]",
                    "roomType": "DOUBLE",
                    "rateId": "12054",
                    "rateDescription": "[Standard - BB]",
                    "boardType": "BB",
                    "boardTypeDescription": "ALOJAMIENTO Y DESAYUNO",
                    "refundable": "partial",
                    "cancellationPolicy": "The guest can cancel free of charge until 2 days before arrival. If cancelled later or in case of no-show, the guest will be charged the first night.",
                    "currency": "EUR",
                    "baseDailyAmounts": [
                        {
                            "day": "2024-02-12",
                            "amountBeforeTax": 1000.0
                        },
                        {
                            "day": "2024-02-13",
                            "amountBeforeTax": 1000.0
                        },
                        {
                            "day": "2024-02-14",
                            "amountBeforeTax": 1000.0
                        }
                    ],
                    "baseRate": {
                        "amountBeforeTax": 3000.0,
                        "amountAfterTax": 3570.0
                    }
                }
            ]
        }
    ]
}

Status code: 401, 403, 404

{
 "code": "Status code",
 "message":"Error description",
 "detail": "Error details"
}