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": 16,
"name": "DEV_Hotel 1525 By Gh Suites",
"roomcloud_id": "15736",
"city": "SANTA_MARTA",
"largest_room_beds": 4
},
"availability": [
{
"adults": 2,
"children_ages": "12,12",
"total_count": 8,
"available_rooms": [
{
"roomId": "104423",
"roomName": "Cuadruple estandar",
"beds": 4,
"adults": 2,
"children_ages": "12,12",
"count": 8,
"products": [
{
"roomId": "104423",
"roomName": "Cuadruple estandar[Booking Connect Mayorista]",
"roomType": "QUADRUPLE",
"rateId": "99087",
"rateDescription": "Standard Quadruple Room[Booking Connect Mayorista]",
"boardType": null,
"boardTypeDescription": "NO ESPECIFICADO",
"refundable": "full",
"cancellationPolicy": "The guest can cancel free of charge until the day of arrival.",
"currency": "COP",
"trm": 3860.92,
"baseDailyAmounts": [
{
"day": "2025-05-03",
"amountAfterTax": 0.0,
"amountBeforeTax": 208800.0,
"amountAfterTaxUSD": 0.0,
"amountBeforeTaxUSD": 54.08
}
],
"baseRate": {
"amountBeforeTax": 208800,
"amountAfterTax": 248472,
"amountBeforeTaxUSD": 54.08,
"amountAfterTaxUSD": 64.36
}
}
]
}
]
},
{
"adults": 4,
"children_ages": null,
"total_count": 0,
"available_rooms": []
}
]
},
{
"hotel": {
"id": 22,
"name": "DEV_Madisson Inn Hotel & Luxury Suites",
"roomcloud_id": "16255",
"city": "SANTA_MARTA",
"largest_room_beds": 4
},
"availability": [
{
"adults": 2,
"children_ages": "12,12",
"total_count": 5,
"available_rooms": [
{
"roomId": "109509",
"roomName": "FAMILIAR",
"beds": 4,
"adults": 2,
"children_ages": "12,12",
"count": 5,
"products": [
{
"roomId": "109509",
"roomName": "FAMILIAR[Booking Connect Mayorista]",
"roomType": "FAMILY",
"rateId": "99109",
"rateDescription": "Family Room[Booking Connect Mayorista]",
"boardType": null,
"boardTypeDescription": "NO ESPECIFICADO",
"refundable": "full",
"cancellationPolicy": "The guest can cancel free of charge until the day of arrival.",
"currency": "COP",
"trm": 3860.92,
"baseDailyAmounts": [
{
"day": "2025-05-03",
"amountAfterTax": 0.0,
"amountBeforeTax": 311370.0,
"amountAfterTaxUSD": 0.0,
"amountBeforeTaxUSD": 80.65
}
],
"baseRate": {
"amountBeforeTax": 311370,
"amountAfterTax": 370530,
"amountBeforeTaxUSD": 80.65,
"amountAfterTaxUSD": 95.97
}
}
]
}
]
},
{
"adults": 4,
"children_ages": null,
"total_count": 0,
"available_rooms": []
}
]
},
{
"hotel": {
"id": 23,
"name": "DEV_Hotel Rodadero Inn",
"roomcloud_id": "17491",
"city": "SANTA_MARTA",
"largest_room_beds": 4
},
"availability": [
{
"adults": 2,
"children_ages": "12,12",
"total_count": 9,
"available_rooms": [
{
"roomId": "125833",
"roomName": "Cuadruple estandar ",
"beds": 4,
"adults": 2,
"children_ages": "12,12",
"count": 9,
"products": [
{
"roomId": "125833",
"roomName": "Cuadruple estandar [Booking Connect Mayorista]",
"roomType": "QUADRUPLE",
"rateId": "99103",
"rateDescription": "Quadruple Standard[Booking Connect Mayorista]",
"boardType": null,
"boardTypeDescription": "NO ESPECIFICADO",
"refundable": "full",
"cancellationPolicy": "The guest can cancel free of charge until the day of arrival.",
"currency": "COP",
"trm": 3860.92,
"baseDailyAmounts": [
{
"day": "2025-05-03",
"amountAfterTax": 0.0,
"amountBeforeTax": 200000.0,
"amountAfterTaxUSD": 0.0,
"amountBeforeTaxUSD": 51.8
}
],
"baseRate": {
"amountBeforeTax": 200000,
"amountAfterTax": 238000,
"amountBeforeTaxUSD": 51.8,
"amountAfterTaxUSD": 61.64
}
}
]
}
]
},
{
"adults": 4,
"children_ages": null,
"total_count": 0,
"available_rooms": []
}
]
},
{
"hotel": {
"id": 43,
"name": "DEV_Hotel Hukumeizi",
"roomcloud_id": null,
"city": "SANTA_MARTA",
"largest_room_beds": 0
},
"availability": [
{
"adults": 2,
"children_ages": "12,12",
"total_count": 0,
"available_rooms": []
},
{
"adults": 4,
"children_ages": null,
"total_count": 0,
"available_rooms": []
}
]
},
{
"hotel": {
"id": 15,
"name": "DEV_Bocagrande Cartagena",
"roomcloud_id": "14364",
"city": "SANTA_MARTA",
"largest_room_beds": 5
},
"availability": [
{
"adults": 2,
"children_ages": "12,12",
"total_count": 4,
"available_rooms": [
{
"roomId": "90133",
"roomName": "Quintuple",
"beds": 5,
"adults": 2,
"children_ages": "12,12",
"count": 2,
"products": [
{
"roomId": "90133",
"roomName": "Quintuple[Booking connect Mayorista]",
"roomType": "FAMILY",
"rateId": "99094",
"rateDescription": "Quintuple[Booking connect Mayorista]",
"boardType": null,
"boardTypeDescription": "NO ESPECIFICADO",
"refundable": "full",
"cancellationPolicy": "The guest can cancel free of charge until the day of arrival.",
"currency": "COP",
"trm": 3860.92,
"baseDailyAmounts": [
{
"day": "2025-05-03",
"amountAfterTax": 0.0,
"amountBeforeTax": 248490.0,
"amountAfterTaxUSD": 0.0,
"amountBeforeTaxUSD": 64.36
}
],
"baseRate": {
"amountBeforeTax": 248490,
"amountAfterTax": 295703,
"amountBeforeTaxUSD": 64.36,
"amountAfterTaxUSD": 76.59
}
}
]
},
{
"roomId": "90131",
"roomName": "Cuadruple ",
"beds": 4,
"adults": 2,
"children_ages": "12,12",
"count": 2,
"products": [
{
"roomId": "90131",
"roomName": "Cuadruple [Booking connect Mayorista]",
"roomType": "QUADRUPLE",
"rateId": "99094",
"rateDescription": "Cuadruple[Booking connect Mayorista]",
"boardType": null,
"boardTypeDescription": "NO ESPECIFICADO",
"refundable": "full",
"cancellationPolicy": "The guest can cancel free of charge until the day of arrival.",
"currency": "COP",
"trm": 3860.92,
"baseDailyAmounts": [
{
"day": "2025-05-03",
"amountAfterTax": 0.0,
"amountBeforeTax": 203490.0,
"amountAfterTaxUSD": 0.0,
"amountBeforeTaxUSD": 52.71
}
],
"baseRate": {
"amountBeforeTax": 203490,
"amountAfterTax": 242153,
"amountBeforeTaxUSD": 52.71,
"amountAfterTaxUSD": 62.72
}
}
]
}
]
},
{
"adults": 4,
"children_ages": null,
"total_count": 0,
"available_rooms": []
}
]
},
{
"hotel": {
"id": 41,
"name": "DEV_Casa Belle Luxury House",
"roomcloud_id": null,
"city": "SANTA_MARTA",
"largest_room_beds": 0
},
"availability": [
{
"adults": 2,
"children_ages": "12,12",
"total_count": 0,
"available_rooms": []
},
{
"adults": 4,
"children_ages": null,
"total_count": 0,
"available_rooms": []
}
]
},
{
"hotel": {
"id": 24,
"name": "DEV_MT Hotel Windsor House Inn By GEH Suites",
"roomcloud_id": "18004",
"city": "SANTA_MARTA",
"largest_room_beds": 3
},
"availability": [
{
"adults": 2,
"children_ages": "12,12",
"total_count": 0,
"available_rooms": []
},
{
"adults": 4,
"children_ages": null,
"total_count": 0,
"available_rooms": []
}
]
},
{
"hotel": {
"id": 17,
"name": "DEV_Hotel Azuan Suites",
"roomcloud_id": "13645",
"city": "SANTA_MARTA",
"largest_room_beds": 4
},
"availability": [
{
"adults": 2,
"children_ages": "12,12",
"total_count": 7,
"available_rooms": [
{
"roomId": "83533",
"roomName": "Habitacion Cuadruple Standard",
"beds": 4,
"adults": 2,
"children_ages": "12,12",
"count": 7,
"products": [
{
"roomId": "83533",
"roomName": "Habitacion Cuadruple Standard[Booking connect Mayorista]",
"roomType": "QUADRUPLE",
"rateId": "99100",
"rateDescription": "Cuadruple[Booking connect Mayorista]",
"boardType": null,
"boardTypeDescription": "NO ESPECIFICADO",
"refundable": "full",
"cancellationPolicy": "The guest can cancel free of charge until the day of arrival.",
"currency": "COP",
"trm": 3860.92,
"baseDailyAmounts": [
{
"day": "2025-05-03",
"amountAfterTax": 0.0,
"amountBeforeTax": 221715.0,
"amountAfterTaxUSD": 0.0,
"amountBeforeTaxUSD": 57.43
}
],
"baseRate": {
"amountBeforeTax": 221715,
"amountAfterTax": 263841,
"amountBeforeTaxUSD": 57.43,
"amountAfterTaxUSD": 68.34
}
}
]
}
]
},
{
"adults": 4,
"children_ages": null,
"total_count": 0,
"available_rooms": []
}
]
}
]
Status code: 401, 403, 404
{
"code": "Status code",
"message":"Error description",
"detail": "Error details"
}