Menu

Product Updates

Filter updates by categories:

2024 October – API Update: GET /groups and GET /groups/{id} now return policy details for new custom groups

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
}
Book a demo Contact Us
×

See how StayNtouch’s Cloud PMS, Guest Mobility, and Guest Kiosk solutions deliver better results for hotels through better front & back of house communication, increased mobile touch-points, more revenue and operational efficiency, and unlimited interfaces.

Your demo will include how to:

Manage and Set Tasks Across Your Departments

Ensure Guest Satisfaction & Safety With Contactless Check-in Options

Automate Easy Upsells & Monetized Early/Late Checkouts

Set & Manage Rates/Availability

Integrate With Tools and Platforms Essential to Your Hotel

And More!

Request a demo