When the new custom group functionality is enabled for a hotel, the following API endpoints now include the cancellation_policy
and deposit_policy
attributes in their responses:
GET /groups
GET /groups/{id}
These policy fields reflect the actual settings defined in the custom group configuration, making it easier to retrieve and display relevant booking terms without additional logic.
For more details on the returned cancellation or deposit policy values, you can query:
GET /hotels/{id}/cancellation_policies
GET /hotels/{id}/deposit_policies
Sample response for the endpoint: GET /groups?code=SATURN-Y
{
"results": [
{
"id": 193181,
"hotel_id": 299,
"code": "SATURN-Y",
"name": "Yellow Saturn Group",
"type": "GROUP",
"from_date": "2025-07-01",
"to_date": "2025-07-03",
"shoulder_days_beginning": 0,
"shoulder_days_end": 0,
"release_date": "2025-07-01",
"first_name": "Pale Yellow",
"last_name": "Saturn",
"hold_status": "Definite",
"posting_account_id": 19191,
"custom_group": true,
"market_segment_code": "Corporate",
"segment_code": "MS1",
"source_code": "Telephone",
"booking_origin_code": "House Use",
"created_date": "2025-06-11",
"updated_date": "2025-06-11",
"room_rates": [
{
"group_id": 193181,
"room_type_id": 1443,
"currency_code": "TZS",
"single": "100.00",
"double": "150.00",
"extra_adult_amount": "50.00"
}
],
"inventories": [
{
"id": 584717,
"group_id": 193181,
"date": "2025-07-01",
"room_type_id": 1443,
"blocked": {
"single": 1,
"double": 1,
"triple": 0,
"quadruple": 0
},
"pickup": {
"single": 0,
"double": 0,
"triple": 0,
"quadruple": 0
},
"available": {
"single": 1,
"double": 1,
"triple": 0,
"quadruple": 0
}
},
{
"id": 584718,
"group_id": 193181,
"date": "2025-07-02",
"room_type_id": 1443,
"blocked": {
"single": 1,
"double": 1,
"triple": 0,
"quadruple": 0
},
"pickup": {
"single": 0,
"double": 0,
"triple": 0,
"quadruple": 0
},
"available": {
"single": 1,
"double": 1,
"triple": 0,
"quadruple": 0
}
}
],
"revenue": [],
"addons": false,
"deposit_policy": {
"id": 350,
"name": "100% Deposit",
"description": "100% deposit"
},
"cancellation_policy": {
"id": 71,
"name": "48 Hours",
"description": "48 hour cancellation policy"
}
}
],
"total_count": 1
}