Get room availability for agencies
Request to obtain room availability based on city, check-in date, number of nights, guest accommodations, and agency type.
POST https://[base_url]/v2/bookings/agencies/{agency_type}/availability?checkin={checkin}&nights={nights}&city={city}
Example:
POST https://[base_url]/v2/bookings/agencies/retailer/availability?checkin=2025-02-22&nights=2&city=BOGOTA
Query parameters
| PARAMETER | TYPE | REQ. | DESCRIPTION |
|---|---|---|---|
| agency_type | String | Yes | The agency type can be "retailer" or "wholesale". |
| checkin | String | Yes | Potential guest check-in date. The format should be YYYY-MM-DD |
| nights | Integer | Yes | Number of nights to reserve. |
| city | String | Yes | City where we want to search for availability |
Body
Request using the POST method
{
"layout": [
{
"adults": 3
},
{
"adults": 1,
"children_ages": [8,3,2]
}
]
}
Endpoint response
Status code: 200
[
{
"hotel": {
"id": 8,
"name": "Hotel Rodadero Inn",
"roomcloud_id": "17491",
"city": "SANTA_MARTA",
"largest_room_beds": 4
},
"availability": [
{
"adults": 3,
"children_ages": null,
"total_count": 19,
"available_rooms": [
{
"roomId": "125833",
"roomName": "Cuadruple estandar ",
"beds": 4,
"adults": 3,
"children_ages": null,
"count": 9,
"products": [
{
"roomId": "125833",
"roomName": "Cuadruple estandar [Booking Connect Neto]",
"roomType": "QUADRUPLE",
"rateId": "99104",
"rateDescription": "Quadruple Standard[Booking Connect Neto]",
"boardType": null,
"boardTypeDescription": "NO ESPECIFICADO",
"refundable": "full",
"cancellationPolicy": "The guest can cancel free of charge until the day of arrival.",
"currency": "COP",
"baseDailyAmounts": [
{
"day": "2025-02-22",
"amountAfterTax": 0.0,
"amountBeforeTax": 265650.0
},
{
"day": "2025-02-23",
"amountAfterTax": 0.0,
"amountBeforeTax": 265650.0
}
],
"baseRate": {
"amountBeforeTax": 531300.0,
"amountAfterTax": 632247.0
}
}
]
},
{
"roomId": "125832",
"roomName": "Triple estandar",
"beds": 3,
"adults": 3,
"children_ages": null,
"count": 10,
"products": [
{
"roomId": "125832",
"roomName": "Triple estandar[Booking Connect Neto]",
"roomType": "TRIPLE",
"rateId": "99104",
"rateDescription": "Triple Standard[Booking Connect Neto]",
"boardType": null,
"boardTypeDescription": "NO ESPECIFICADO",
"refundable": "full",
"cancellationPolicy": "The guest can cancel free of charge until the day of arrival.",
"currency": "COP",
"baseDailyAmounts": [
{
"day": "2025-02-22",
"amountAfterTax": 0.0,
"amountBeforeTax": 205275.0
},
{
"day": "2025-02-23",
"amountAfterTax": 0.0,
"amountBeforeTax": 205275.0
}
],
"baseRate": {
"amountBeforeTax": 410550.0,
"amountAfterTax": 488554.5
}
}
]
}
]
},
{
"adults": 1,
"children_ages": "8,3,2",
"total_count": 9,
"available_rooms": [
{
"roomId": "125833",
"roomName": "Cuadruple estandar ",
"beds": 4,
"adults": 1,
"children_ages": "8,3,2",
"count": 9,
"products": [
{
"roomId": "125833",
"roomName": "Cuadruple estandar [Booking Connect Neto]",
"roomType": "QUADRUPLE",
"rateId": "99104",
"rateDescription": "Quadruple Standard[Booking Connect Neto]",
"boardType": null,
"boardTypeDescription": "NO ESPECIFICADO",
"refundable": "full",
"cancellationPolicy": "The guest can cancel free of charge until the day of arrival.",
"currency": "COP",
"baseDailyAmounts": [
{
"day": "2025-02-22",
"amountAfterTax": 0.0,
"amountBeforeTax": 265650.0
},
{
"day": "2025-02-23",
"amountAfterTax": 0.0,
"amountBeforeTax": 265650.0
}
],
"baseRate": {
"amountBeforeTax": 531300.0,
"amountAfterTax": 632247.0
}
}
]
}
]
}
]
},
{
"hotel": {
"id": 2,
"name": "Hotel 1525 By Gh Suites",
"roomcloud_id": "15736",
"city": "SANTA_MARTA",
"largest_room_beds": 4
},
"availability": [
{
"adults": 3,
"children_ages": null,
"total_count": 9,
"available_rooms": [
{
"roomId": "104423",
"roomName": "Cuadruple estandar",
"beds": 4,
"adults": 3,
"children_ages": null,
"count": 4,
"products": [
{
"roomId": "104423",
"roomName": "Cuadruple estandar[Booking Connect Neto]",
"roomType": "QUADRUPLE",
"rateId": "99086",
"rateDescription": "Standard Quadruple Room[Booking Connect Neto]",
"boardType": null,
"boardTypeDescription": "NO ESPECIFICADO",
"refundable": "full",
"cancellationPolicy": "The guest can cancel free of charge until the day of arrival.",
"currency": "COP",
"baseDailyAmounts": [
{
"day": "2025-02-22",
"amountAfterTax": 0.0,
"amountBeforeTax": 292320.0
},
{
"day": "2025-02-23",
"amountAfterTax": 0.0,
"amountBeforeTax": 292320.0
}
],
"baseRate": {
"amountBeforeTax": 584640.0,
"amountAfterTax": 695721.6
}
}
]
},
{
"roomId": "104422",
"roomName": "Triple Estandar",
"beds": 3,
"adults": 3,
"children_ages": null,
"count": 5,
"products": [
{
"roomId": "104422",
"roomName": "Triple Estandar[Booking Connect Neto]",
"roomType": "TRIPLE",
"rateId": "99086",
"rateDescription": "Standard Triple Room[Booking Connect Neto]",
"boardType": null,
"boardTypeDescription": "NO ESPECIFICADO",
"refundable": "full",
"cancellationPolicy": "The guest can cancel free of charge until the day of arrival.",
"currency": "COP",
"baseDailyAmounts": [
{
"day": "2025-02-22",
"amountAfterTax": 0.0,
"amountBeforeTax": 231420.0
},
{
"day": "2025-02-23",
"amountAfterTax": 0.0,
"amountBeforeTax": 231420.0
}
],
"baseRate": {
"amountBeforeTax": 462840.0,
"amountAfterTax": 550779.6
}
}
]
}
]
},
{
"adults": 1,
"children_ages": "8,3,2",
"total_count": 4,
"available_rooms": [
{
"roomId": "104423",
"roomName": "Cuadruple estandar",
"beds": 4,
"adults": 1,
"children_ages": "8,3,2",
"count": 4,
"products": [
{
"roomId": "104423",
"roomName": "Cuadruple estandar[Booking Connect Neto]",
"roomType": "QUADRUPLE",
"rateId": "99086",
"rateDescription": "Standard Quadruple Room[Booking Connect Neto]",
"boardType": null,
"boardTypeDescription": "NO ESPECIFICADO",
"refundable": "full",
"cancellationPolicy": "The guest can cancel free of charge until the day of arrival.",
"currency": "COP",
"baseDailyAmounts": [
{
"day": "2025-02-22",
"amountAfterTax": 0.0,
"amountBeforeTax": 292320.0
},
{
"day": "2025-02-23",
"amountAfterTax": 0.0,
"amountBeforeTax": 292320.0
}
],
"baseRate": {
"amountBeforeTax": 584640.0,
"amountAfterTax": 695721.6
}
}
]
}
]
}
]
}
]
Status code: 401, 403, 404
{
"code": "Status code",
"message":"Error description",
"detail": "Error details"
}