Content Solutions Knowledge Base

TABLE OF CONTENTS

Introduction
Get Guestroom
Get Guestroom Content with {guestRoomCode}
POST Guestroom Content
Related Articles:

Introduction

Get Guestroom: This API retrieves a list of guest rooms for a specified property within the system, providing detailed room information.
Get Guestroom Content with {guestRoomCode}: This API retrieves the content details of a specific guest room using the provided {guestroomCode}, allowing users to query a single room's information within a specified property.
POST Guestroom Content: This API performs a full update of guest room content in the system, replacing all existing data with the new submission for a specified property.

Get Guestroom

This API retrieves a list of guest rooms for a specified property within the system, providing detailed room information.

API Endpoints & Methods

Base URL: https://contentsolutions-supplier.derbysoftsec.com
HTTP method	URL
GET	/api/content/guest_rooms

Headers

Name	Type	Required	Description	Example
Authorization	String	required	Basic Authentication token for API access.	Basic Vz********MTI=
Content-Type	String	required	Specifies the media type of the request.	application/json;charset=UTF-8

Query Parameters

Parameter	Type	Required	Description	Example
contextCode	String(query)	Yes	Context Code in DerbySoft's system.	DERBYDEMO
propertyCode	String(query)	Yes	Property code provided by content suppliers, only the following characters are allowed. 1. Digits (0-9) 2. Uppercase letters (A-Z) 3. Hyphen ('-')	BONITAPROPERTY

Parameter

Type

Required

Description

Example

contextCode

String(query)

Yes

Context Code in DerbySoft's system.

DERBYDEMO

propertyCode

String(query)

Yes

Property code provided by content suppliers, only the following characters are allowed.

1. Digits (0-9)

2. Uppercase letters (A-Z)

3. Hyphen ('-')

BONITAPROPERTY

Response Parameters

Parameter	Type	Description	Example
contextCode	String	Context Code in DerbySoft's system.	DERBYDEMO
supplierCode	String	Supplier Code in DerbySoft's system.	DERBYDEMO
propertyCode	String	Property code provided by content suppliers, only the following characters are allowed. 1. Digits (0-9) 2. Uppercase letters (A-Z) 3. Hyphen ('-')	BONITAPROPERTY
operateStatus	String	Indicates the operational status of the property. Enum: [ ENABLED, PAUSED ]	ENABLED
guestRooms	List<RoomType>	List of property room types.
guestRooms.code	String	Unique code identifying the room type.
guestRooms.quantity	Integer	Room quantity
guestRooms.sort		Room sort
guestRooms.roomTypeNameLangs	List<I18N>	Multilingual name of the room type name.
guestRooms.descriptionLangs	List<I18N>	Multilingual description of the room type.
guestRooms.area	Integer	Room size in square units (feet/meters).
guestRooms.nameLangs	List<I18N>	Multilingual name of the type room name.
guestRooms.unit	String	Number of square units (feet or meters) that defines the size of a room type.
guestRooms.roomCategoryCode	String	Room category (e.g., Moderate, Standard, Deluxe). Refer to OpenTravel Segment Category Code (SEG).
guestRooms.roomLocationCode	String	Room location within the property (e.g., Near Exit, Low Floor). Refer to OpenTravel Room Location Type (RLT).
guestRooms.roomViewCode	String	Room view type (e.g., Ocean View, Garden View). Refer to OpenTravel Room View Type (RVT).
guestRooms.window	Boolean	If true, the room has a window.
guestRooms.nonsmoking	Boolean	If true, the room is non-smoking.
guestRooms.accessibleRoom	Boolean	If true, the room is accessible.
guestRooms.occupancy	Object<Occupancy>	Maximum and minimum occupancy details.
guestRooms.occupancy.maxOccupancy	Integer	Maximum guests allowed.
guestRooms.occupancy.minOccupancy	Integer	Minimum guests required.
guestRooms.occupancy.maxAdultOccupancy	Integer	Maximum number of adults allowed.
guestRooms.occupancy.maxChildOccupancy	Integer	Maximum number of children allowed.
guestRooms.numberOfRoom	Object <NumberOfRoom>	Breakdown of room composition.
guestRooms.numberOfRoom.bedrooms	Integer	Number of bedrooms.
guestRooms.numberOfRoom.bathrooms	Integer	Number of bathrooms.
guestRooms.numberOfRoom.livingRooms	Integer	Number of living rooms.
guestRooms.bedInformation	Object <BedInformation>	Details on bed types and availability.
guestRooms.bedInformation.maxRollaways	Integer	Maximum rollaway beds allowed.
guestRooms.bedInformation.maxCribs	Integer	Maximum cribs allowed.
guestRooms.bedInformation.bedTypes	List<BedType>	List of available bed types.
guestRooms.bedInformation.bedTypes.code	String	Bed type (e.g., Double, Queen, King). Refer to OpenTravel Bed Type Code (BED).
guestRooms.bedInformation.bedTypes.count	Integer	Number of beds of this type.
guestRooms.amenities	List<Amenity>	List of room amenities.
guestRooms.amenities.id	String	Unique ID for the amenity.
guestRooms.amenities.code	String	Amenity type. Refer to OpenTravel Room Amenity Type (RMA).
guestRooms.amenities.detailLangs	List<I18N>	Multilingual details of the amenity.
guestRooms.amenities.descriptionLangs	List<I18N>	Multilingual description of the amenity.
guestRooms.amenities.included	Boolean	If true, the amenity is included in the room rate.
guestRooms.amenities.proximityCode	String	Amenity availability (onsite/offsite). Refer to OpenTravel Proximity Code (PRX).
guestRooms.amenities.quantity	Integer	Number of this amenity in the room.
guestRooms.amenities.operationSchedules	List <OperationScheduleDate>	Amenity operating times and charges.
guestRooms.amenities.operationSchedules. start	String	Start date. Must follow the format yyyy-MM-dd (Year-Month-Day), e.g., 2023-11-22.
guestRooms.amenities.operationSchedules. end	String	End date. Must follow the format yyyy-MM-dd (Year-Month-Day), e.g., 2023-11-22.
guestRooms.amenities.operationSchedules. operationTimes	List <OperationScheduleTime>	List of operation times.
guestRooms.amenities.operationSchedules. operationTimes.weekDays	List<String>	Day of operation. Enum: [ MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY ]
guestRooms.amenities.operationSchedules. operationTimes.start	String	Start time. Must follow the format HH:mm (Hour:Minute, 24-hour format), e.g., 10:22.
guestRooms.amenities.operationSchedules. operationTimes.end	String	End time. Must follow the format HH:mm (Hour:Minute, 24-hour format), e.g., 10:22.
guestRooms.amenities.operationSchedules. operationTimes.descriptionLangs	List<I18N>	OperationTime descriptions
guestRooms.amenities.operationSchedules. charges	List<ServiceCharge>	Charges for the amenity.
guestRooms.amenities.operationSchedules. charges.amount	Double	Fixed fee amount.
guestRooms.amenities.operationSchedules. charges.percent	Double	Fee percentage of total stay.
guestRooms.amenities.operationSchedules. charges.currencyCode	String	Currency code for the charge.
guestRooms.amenities.operationSchedules. charges.unitCode	String	Charge unit. Refer to OpenTravel Charge Type (CHG).
guestRooms.amenities.operationSchedules. charges.frequencyCode	String	Frequency of charge (e.g., Daily, Stay).
guestRooms.accessibleFeatures	List<Feature>	Accessibility features of the room.
guestRooms.accessibleFeatures.id	String	Unique ID.
guestRooms.accessibleFeatures.code	String	Accessibility feature. Refer to OpenTravel Disability Feature Code (PHY).
guestRooms.accessibleFeatures.detailLangs	List<I18N>	Multilingual details of accessibility features.
guestRooms.accessibleFeatures.quantity	Integer	Number of accessible units.
guestRooms.accessibleFeatures.unit	String	Unit of measure (e.g., meters, feet).
guestRooms.accessibleFeatures. chargeCurrencyCode	String	Currency for accessibility-related charges.
guestRooms.accessibleFeatures.chargeAmount	Double	Fixed charge amount.
guestRooms.accessibleFeatures. descriptionLangs	List<I18N>	Multilingual description of accessibility features.
guestRooms.securityFeatures	List<Feature>	Security features available in the room.
guestRooms.securityFeatures.id	String	Unique ID.
guestRooms.securityFeatures.code	String	Security feature type. Refer to OpenTravel Proximity Code (PRX).
guestRooms.securityFeatures.detailLangs	List<I18N>	Multilingual details of security features.
guestRooms.securityFeatures.quantity	Integer	Number of security features in the room.
guestRooms.securityFeatures.unit	String	Unit of measure (e.g., meters, feet).
guestRooms.securityFeatures. chargeCurrencyCode	String	Currency for security-related charges.
guestRooms.securityFeatures.chargeAmount	Double	Fixed charge amount.
guestRooms.securityFeatures.descriptionLangs	List<I18N>	Multilingual description of security features.
guestRooms.images	List<Image>	Collection of multimedia images.
guestRooms.images.categoryCode	String	Image category. Refer to OpenTravel Picture Category Code (PIC).
guestRooms.images.sort	Integer	Display order of images.
guestRooms.images.sourceId	String	Unique ID of the image source (e.g., original file identifier).
guestRooms.images.captionLangs	List<I18N>	Multilingual image captions.
guestRooms.images.applicableStart	Date Format: yyyy-MM-dd	Start date or recurring start period when the image is relevant (e.g., season start).
guestRooms.images.applicableEnd	Date Format: yyyy-MM-dd	End date or recurring end period when the image is relevant (e.g., season end).
guestRooms.images.mainUrl		The main image url is required.
guestRooms.images.items	List<ImageItem>	List of image file variations.
guestRooms.images.items.url	String	URL of the image.
guestRooms.images.items.width	Integer	Image width (unit defined by UOM).
guestRooms.images.items.height	Integer	Image height (unit defined by UOM).
guestRooms.images.items.size	String	Image file size (e.g., MB, KB).
guestRooms.images.items.unit	String	Unit of measurement. Refer to OpenTravel Unit of Measure (UOM).
guestRooms.images.items.fileSize	Integer	File size in bytes.
guestRooms.images.items.formatCode	String	Image format (e.g., JPEG, PNG). Refer to OpenTravel Content Format Code (CFC).
guestRooms.images.items.resolution	Integer	Image resolution in DPI (Dots Per Inch).
guestRooms.images.items.recordId	String	Unique identifier for this image record.

Example Response

Success Response (HTTP Status 200)

{
  "data": {
    "contextCode": "derbydemo",
    "supplierCode": "DERBYHOTEL",
    "propertyCode": "derbydemo001",
    "operateStatus": "ENABLED",
    "guestRooms": [
      {
        "code": "STD-KING",
        "roomId": "DSDH-STD-001",
        "codeContext": "ROOM_TYPE",
        "roomTypeNameLangs": [
          {
            "languageCode": "EN-US",
            "value": "Standard King Room"
          }
        ],
        "nameLangs": [
          {
            "languageCode": "EN-US",
            "value": "Standard King Room - City View"
          }
        ],
        "descriptionLangs": [
          {
            "languageCode": "EN-US",
            "value": "30 sqm room with king-size bed, free Wi-Fi, flat-screen TV, and rain shower. Non-smoking."
          }
        ],
        "quantity": 50,
        "accessibleIndicator": false,
        "area": 30,
        "sort": 1,
        "unit": "SQUARE_METER",
        "roomCategoryCode": "STANDARD",
        "roomLocationCode": "MID_FLOOR",
        "roomViewCode": "CITY",
        "window": true,
        "nonsmoking": true,
        "accessibleRoom": false,
        "occupancy": {
          "maxOccupancy": 2,
          "minOccupancy": 1,
          "maxAdultOccupancy": 2,
          "maxChildOccupancy": 1
        },
        "numberOfRoom": {
          "bedrooms": 1,
          "bathrooms": 1,
          "livingRooms": 0
        },
        "bedInformation": {
          "bedTypes": [
            {
              "code": "KING",
              "count": 1
            }
          ],
          "maxRollaways": 0,
          "maxCribs": 1
        },
        "amenities": [
          {
            "id": "RM-AM-001",
            "code": "WIFI",
            "detailLangs": [
              {
                "languageCode": "EN-US",
                "value": "Free High-Speed Wi-Fi"
              }
            ],
            "descriptionLangs": [
              {
                "languageCode": "EN-US",
                "value": "Complimentary 1Gbps wireless internet"
              }
            ],
            "included": true,
            "proximityCode": "IN_ROOM",
            "quantity": 0,
            "operationSchedules": [],
            "features": []
          }
        ],
        "accessibleFeatures": [],
        "securityFeatures": [
          {
            "id": "RM-SEC-001",
            "code": "SAFE",
            "detailLangs": [
              {
                "languageCode": "EN-US",
                "value": "In-Room Safe"
              }
            ],
            "descriptionLangs": [
              {
                "languageCode": "EN-US",
                "value": "Laptop-sized safe for valuables"
              }
            ],
            "quantity": 1,
            "unit": "PIECE",
            "chargeCurrencyCode": "",
            "chargeAmount": 0
          }
        ],
        "images": [
          {
            "mainUrl": "https://www.derbysoftdemohotel.com/images/rooms/standard-king.jpg",
            "richMediaUrl": "",
            "categoryCode": "ROOM_INTERIOR",
            "sort": 1,
            "sourceId": "RM-IMG-001",
            "captionLangs": [
              {
                "languageCode": "EN-US",
                "value": "Standard King Room"
              }
            ],
            "applicableStart": "2024-01-01",
            "applicableEnd": "2024-12-31",
            "items": [
              {
                "url": "https://www.derbysoftdemohotel.com/images/rooms/standard-king-1.jpg",
                "width": 1920,
                "height": 1080,
                "size": "LARGE",
                "unit": "PIXEL",
                "fileSize": 1800,
                "resolution": 300,
                "recordId": "RM-IMG-ITEM-001",
                "formatCode": "JPG"
              }
            ],
            "lastUpdated": "2023-12-01"
          }
        ],
        "extensions": {
          "additionalProp1": "Coffee/Tea Maker",
          "additionalProp2": "",
          "additionalProp3": ""
        }
      }
    ]
  }
}

Error Response (HTTP Status 403)

{
    "error": {
        "code": "FORBIDDEN",
        "message": "Lack of permissions, please configure permissions."
    }
}

Error Response (HTTP Status 400)

{
    "error": {
        "code": "MissingField",
        "message": "Required request parameter 'contextCode' for method parameter type String is not present"
    }
}

Get Guestroom Content with {guestRoomCode}

This API retrieves the content details of a specific guest room using the provided {guestroomCode}, allowing users to query a single room's information within a specified property.

API Endpoints & Methods

Base URL: https://contentsolutions-supplier.derbysoftsec.com
HTTP method	URL
GET	/api/content/guest_rooms/{guestRoomCode}

Headers

Name	Type	Required	Description	Example
Authorization	String	required	Basic Authentication token for API access.	Basic Vz********MTI=
Content-Type	String	required	Specifies the media type of the request.	application/json;charset=UTF-8

Query Parameters

Parameter	Type	Required	Description	Example
guestRoomCode	String(path)	Yes	Unique code identifying the room type.	DLX-KING
contextCode	String(query)	Yes	Context Code in DerbySoft's system.	DERBYDEMO
propertyCode	String(query)	Yes	Property code provided by content suppliers, only the following characters are allowed. 1. Digits (0-9) 2. Uppercase letters (A-Z) 3. Hyphen ('-')	BONITAPROPERTY

Parameter

Type

Required

Description

Example

guestRoomCode

String(path)

Yes

Unique code identifying the room type.

DLX-KING

contextCode

String(query)

Yes

Context Code in DerbySoft's system.

DERBYDEMO

propertyCode

String(query)

Yes

Property code provided by content suppliers, only the following characters are allowed.

1. Digits (0-9)

2. Uppercase letters (A-Z)

3. Hyphen ('-')

BONITAPROPERTY

Response Parameters

Refers to [GET Guestroom] Response Parameters.

Example Response

Success Response (HTTP Status 200)

{
  "data": {
    "contextCode": "derbydemo",
    "supplierCode": "DERBYHOTEL",
    "propertyCode": "derbydemo001",
    "operateStatus": "ENABLED",
    "guestRooms": [
      {
        "code": "STD-KING",
        "roomId": "DSDH-STD-001",
        "codeContext": "ROOM_TYPE",
        "roomTypeNameLangs": [
          {
            "languageCode": "EN-US",
            "value": "Standard King Room"
          }
        ],
        "nameLangs": [
          {
            "languageCode": "EN-US",
            "value": "Standard King Room - City View"
          }
        ],
        "descriptionLangs": [
          {
            "languageCode": "EN-US",
            "value": "30 sqm room with king-size bed, free Wi-Fi, flat-screen TV, and rain shower. Non-smoking."
          }
        ],
        "quantity": 50,
        "accessibleIndicator": false,
        "area": 30,
        "sort": 1,
        "unit": "SQUARE_METER",
        "roomCategoryCode": "STANDARD",
        "roomLocationCode": "MID_FLOOR",
        "roomViewCode": "CITY",
        "window": true,
        "nonsmoking": true,
        "accessibleRoom": false,
        "occupancy": {
          "maxOccupancy": 2,
          "minOccupancy": 1,
          "maxAdultOccupancy": 2,
          "maxChildOccupancy": 1
        },
        "numberOfRoom": {
          "bedrooms": 1,
          "bathrooms": 1,
          "livingRooms": 0
        },
        "bedInformation": {
          "bedTypes": [
            {
              "code": "KING",
              "count": 1
            }
          ],
          "maxRollaways": 0,
          "maxCribs": 1
        },
        "amenities": [
          {
            "id": "RM-AM-001",
            "code": "WIFI",
            "detailLangs": [
              {
                "languageCode": "EN-US",
                "value": "Free High-Speed Wi-Fi"
              }
            ],
            "descriptionLangs": [
              {
                "languageCode": "EN-US",
                "value": "Complimentary 1Gbps wireless internet"
              }
            ],
            "included": true,
            "proximityCode": "IN_ROOM",
            "quantity": 0,
            "operationSchedules": [],
            "features": []
          }
        ],
        "accessibleFeatures": [],
        "securityFeatures": [
          {
            "id": "RM-SEC-001",
            "code": "SAFE",
            "detailLangs": [
              {
                "languageCode": "EN-US",
                "value": "In-Room Safe"
              }
            ],
            "descriptionLangs": [
              {
                "languageCode": "EN-US",
                "value": "Laptop-sized safe for valuables"
              }
            ],
            "quantity": 1,
            "unit": "PIECE",
            "chargeCurrencyCode": "",
            "chargeAmount": 0
          }
        ],
        "images": [
          {
            "mainUrl": "https://www.derbysoftdemohotel.com/images/rooms/standard-king.jpg",
            "richMediaUrl": "",
            "categoryCode": "ROOM_INTERIOR",
            "sort": 1,
            "sourceId": "RM-IMG-001",
            "captionLangs": [
              {
                "languageCode": "EN-US",
                "value": "Standard King Room"
              }
            ],
            "applicableStart": "2024-01-01",
            "applicableEnd": "2024-12-31",
            "items": [
              {
                "url": "https://www.derbysoftdemohotel.com/images/rooms/standard-king-1.jpg",
                "width": 1920,
                "height": 1080,
                "size": "LARGE",
                "unit": "PIXEL",
                "fileSize": 1800,
                "resolution": 300,
                "recordId": "RM-IMG-ITEM-001",
                "formatCode": "JPG"
              }
            ],
            "lastUpdated": "2023-12-01"
          }
        ],
        "extensions": {
          "additionalProp1": "Coffee/Tea Maker",
          "additionalProp2": "",
          "additionalProp3": ""
        }
      }
    ]
  }
}

Error Response (HTTP Status 403)

{
    "error": {
        "code": "FORBIDDEN",
        "message": "Lack of permissions, please configure permissions."
    }
}

Error Response (HTTP Status 400)

{
    "error": {
        "code": "MissingField",
        "message": "Required request parameter 'contextCode' for method parameter type String is not present"
    }
}

POST Guestroom Content

This API performs a full update of guest room content in the system, replacing all existing data with the new submission for a specified property.

API Endpoints & Methods

Base URL: https://contentsolutions-supplier.derbysoftsec.com
HTTP method	URL
POST	/api/content/guest_rooms/batch_save

Headers

Name	Type	Required	Description	Example
Authorization	String	required	Basic Authentication token for API access.	Basic Vz********MTI=
Content-Type	String	required	Specifies the media type of the request.	application/json;charset=UTF-8

Query Parameters

Parameter	Type	Description	Example
contextCode	String	Context Code in DerbySoft's system.	DERBYDEMO
propertyCode	String	Property code provided by content suppliers, only the following characters are allowed. 1. Digits (0-9) 2. Uppercase letters (A-Z) 3. Hyphen ('-')	BONITAPROPERTY
guestRooms	List<RoomType>	List of property room types.
guestRooms.code	String	Unique code identifying the room type.
guestRooms.quantity	Integer	Room quantity
guestRooms.sort		Room sort
guestRooms.roomTypeNameLangs	List<I18N>	Multilingual name of the room type name.
guestRooms.descriptionLangs	List<I18N>	Multilingual description of the room type.
guestRooms.area	Integer	Room size in square units (feet/meters).
guestRooms.nameLangs	List<I18N>	Multilingual name of the type room name.
guestRooms.unit	String	Number of square units (feet or meters) that defines the size of a room type.
guestRooms.roomCategoryCode	String	Room category (e.g., Moderate, Standard, Deluxe). Refer to OpenTravel Segment Category Code (SEG).
guestRooms.roomLocationCode	String	Room location within the property (e.g., Near Exit, Low Floor). Refer to OpenTravel Room Location Type (RLT).
guestRooms.roomViewCode	String	Room view type (e.g., Ocean View, Garden View). Refer to OpenTravel Room View Type (RVT).
guestRooms.window	Boolean	If true, the room has a window.
guestRooms.nonsmoking	Boolean	If true, the room is non-smoking.
guestRooms.accessibleRoom	Boolean	If true, the room is accessible.
guestRooms.occupancy	Object<Occupancy>	Maximum and minimum occupancy details.
guestRooms.occupancy.maxOccupancy	Integer	Maximum guests allowed.
guestRooms.occupancy.minOccupancy	Integer	Minimum guests required.
guestRooms.occupancy.maxAdultOccupancy	Integer	Maximum number of adults allowed.
guestRooms.occupancy.maxChildOccupancy	Integer	Maximum number of children allowed.
guestRooms.numberOfRoom	Object<NumberOfRoom>	Breakdown of room composition.
guestRooms.numberOfRoom.bedrooms	Integer	Number of bedrooms.
guestRooms.numberOfRoom.bathrooms	Integer	Number of bathrooms.
guestRooms.numberOfRoom.livingRooms	Integer	Number of living rooms.
guestRooms.bedInformation	Object<BedInformation>	Details on bed types and availability.
guestRooms.bedInformation.maxRollaways	Integer	Maximum rollaway beds allowed.
guestRooms.bedInformation.maxCribs	Integer	Maximum cribs allowed.
guestRooms.bedInformation.bedTypes	List<BedType>	List of available bed types.
guestRooms.bedInformation.bedTypes.code	String	Bed type (e.g., Double, Queen, King). Refer to OpenTravel Bed Type Code (BED).
guestRooms.bedInformation.bedTypes.count	Integer	Number of beds of this type.
guestRooms.amenities	List<Amenity>	List of room amenities.
guestRooms.amenities.id	String	Unique ID for the amenity.
guestRooms.amenities.code	String	Amenity type. Refer to OpenTravel Room Amenity Type (RMA).
guestRooms.amenities.detailLangs	List<I18N>	Multilingual details of the amenity.
guestRooms.amenities.descriptionLangs	List<I18N>	Multilingual description of the amenity.
guestRooms.amenities.included	Boolean	If true, the amenity is included in the room rate.
guestRooms.amenities.proximityCode	String	Amenity availability (onsite/offsite). Refer to OpenTravel Proximity Code (PRX).
guestRooms.amenities.quantity	Integer	Number of this amenity in the room.
guestRooms.amenities.operationSchedules	List <OperationScheduleDate>	Amenity operating times and charges.
guestRooms.amenities.operationSchedules.start	String	Start date. Must follow the format yyyy-MM-dd (Year-Month-Day), e.g., 2023-11-22.
guestRooms.amenities.operationSchedules.end	String	End date. Must follow the format yyyy-MM-dd (Year-Month-Day), e.g., 2023-11-22.
guestRooms.amenities.operationSchedules. operationTimes	List <OperationScheduleTime>	List of operation times.
guestRooms.amenities.operationSchedules. operationTimes.weekDays	List<String>	Day of operation. Enum: [ MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY ]
guestRooms.amenities.operationSchedules. operationTimes.start	String	Start time. Must follow the format HH:mm (Hour:Minute, 24-hour format), e.g., 10:22.
guestRooms.amenities.operationSchedules. operationTimes.end	String	End time. Must follow the format HH:mm (Hour:Minute, 24-hour format), e.g., 10:22.
guestRooms.amenities.operationSchedules.charges	List<ServiceCharge>	Charges for the amenity.
guestRooms.amenities.operationSchedules. charges.amount	Double	Fixed fee amount.
guestRooms.amenities.operationSchedules. charges.percent	Double	Fee percentage of total stay.
guestRooms.amenities.operationSchedules. charges.currencyCode	String	Currency code for the charge.
guestRooms.amenities.operationSchedules. charges.unitCode	String	Charge unit. Refer to OpenTravel Charge Type (CHG).
guestRooms.amenities.operationSchedules. charges.frequencyCode	String	Frequency of charge (e.g., Daily, Stay).
guestRooms.accessibleFeatures	List<Feature>	Accessibility features of the room.
guestRooms.accessibleFeatures.id	String	Unique ID.
guestRooms.accessibleFeatures.code	String	Accessibility feature. Refer to OpenTravel Disability Feature Code (PHY).
guestRooms.accessibleFeatures.detailLangs	List<I18N>	Multilingual details of accessibility features.
guestRooms.accessibleFeatures.quantity	Integer	Number of accessible units.
guestRooms.accessibleFeatures.unit	String	Unit of measure (e.g., meters, feet).
guestRooms.accessibleFeatures.chargeCurrencyCode	String	Currency for accessibility-related charges.
guestRooms.accessibleFeatures.chargeAmount	Double	Fixed charge amount.
guestRooms.accessibleFeatures.descriptionLangs	List<I18N>	Multilingual description of accessibility features.
guestRooms.securityFeatures	List<Feature>	Security features available in the room.
guestRooms.securityFeatures.id	String	Unique ID.
guestRooms.securityFeatures.code	String	Security feature type. Refer to OpenTravel Proximity Code (PRX).
guestRooms.securityFeatures.detailLangs	List<I18N>	Multilingual details of security features.
guestRooms.securityFeatures.quantity	Integer	Number of security features in the room.
guestRooms.securityFeatures.unit	String	Unit of measure (e.g., meters, feet).
guestRooms.securityFeatures.chargeCurrencyCode	String	Currency for security-related charges.
guestRooms.securityFeatures.chargeAmount	Double	Fixed charge amount.
guestRooms.securityFeatures.descriptionLangs	List<I18N>	Multilingual description of security features.
guestRooms.images	List<Image>	Collection of multimedia images.
guestRooms.images.categoryCode	String	Image category. Refer to OpenTravel Picture Category Code (PIC).
guestRooms.images.sort	Integer	Display order of images.
guestRooms.images.sourceId	String	Unique ID of the image source (e.g., original file identifier).
guestRooms.images.captionLangs	List<I18N>	Multilingual image captions.
guestRooms.images.applicableStart	Date Format: yyyy-MM-dd	Start date or recurring start period when the image is relevant (e.g., season start).
guestRooms.images.applicableEnd	Date Format: yyyy-MM-dd	End date or recurring end period when the image is relevant (e.g., season end).
guestRooms.images.mainUrl		The main image url is required.
guestRooms.images.items	List<ImageItem>	List of image file variations.
guestRooms.images.items.url	String	URL of the image.
guestRooms.images.items.width	Integer	Image width (unit defined by UOM).
guestRooms.images.items.height	Integer	Image height (unit defined by UOM).
guestRooms.images.items.size	String	Image file size (e.g., MB, KB).
guestRooms.images.items.unit	String	Unit of measurement. Refer to OpenTravel Unit of Measure (UOM).
guestRooms.images.items.fileSize	Integer	File size in bytes.
guestRooms.images.items.formatCode	String	Image format (e.g., JPEG, PNG). Refer to OpenTravel Content Format Code (CFC).
guestRooms.images.items.resolution	Integer	Image resolution in DPI (Dots Per Inch).
guestRooms.images.items.recordId	String	Unique identifier for this image record.

Example Request

{
  "contextCode": "HOTEL",
  "propertyCode": "DSDH001",
  "guestRooms": [
    {
      "code": "STD-KING",
      "roomId": "DSDH-STD-001",
      "codeContext": "ROOM_TYPE",
      "roomTypeNameLangs": [
        {
          "languageCode": "EN-US",
          "value": "Standard King Room"
        }
      ],
      "nameLangs": [
        {
          "languageCode": "EN-US",
          "value": "Standard King Room - City View"
        }
      ],
      "descriptionLangs": [
        {
          "languageCode": "EN-US",
          "value": "30 sqm room with king-size bed, free Wi-Fi, flat-screen TV, and rain shower. Non-smoking."
        }
      ],
      "quantity": 50,
      "accessibleIndicator": false,
      "area": 30,
      "sort": 1,
      "unit": "SQUARE_METER",
      "roomCategoryCode": "STANDARD",
      "roomLocationCode": "MID_FLOOR",
      "roomViewCode": "CITY",
      "window": true,
      "nonsmoking": true,
      "accessibleRoom": false,
      "occupancy": {
        "maxOccupancy": 2,
        "minOccupancy": 1,
        "maxAdultOccupancy": 2,
        "maxChildOccupancy": 1
      },
      "numberOfRoom": {
        "bedrooms": 1,
        "bathrooms": 1,
        "livingRooms": 0
      },
      "bedInformation": {
        "bedTypes": [
          {
            "code": "KING",
            "count": 1
          }
        ],
        "maxRollaways": 0,
        "maxCribs": 1
      },
      "amenities": [
        {
          "id": "RM-AM-001",
          "code": "WIFI",
          "detailLangs": [
            {
              "languageCode": "EN-US",
              "value": "Free High-Speed Wi-Fi"
            }
          ],
          "descriptionLangs": [
            {
              "languageCode": "EN-US",
              "value": "Complimentary 1Gbps wireless internet"
            }
          ],
          "included": true,
          "proximityCode": "IN_ROOM",
          "quantity": 0,
          "operationSchedules": [],
          "features": []
        }
      ],
      "accessibleFeatures": [],
      "securityFeatures": [
        {
          "id": "RM-SEC-001",
          "code": "SAFE",
          "detailLangs": [
            {
              "languageCode": "EN-US",
              "value": "In-Room Safe"
            }
          ],
          "descriptionLangs": [
            {
              "languageCode": "EN-US",
              "value": "Laptop-sized safe for valuables"
            }
          ],
          "quantity": 1,
          "unit": "PIECE",
          "chargeCurrencyCode": "",
          "chargeAmount": 0
        }
      ],
      "images": [
        {
          "mainUrl": "https://www.derbysoftdemohotel.com/images/rooms/standard-king.jpg",
          "richMediaUrl": "",
          "categoryCode": "ROOM_INTERIOR",
          "sort": 1,
          "sourceId": "RM-IMG-001",
          "captionLangs": [
            {
              "languageCode": "EN-US",
              "value": "Standard King Room"
            }
          ],
          "applicableStart": "2024-01-01",
          "applicableEnd": "2024-12-31",
          "items": [
            {
              "url": "https://www.derbysoftdemohotel.com/images/rooms/standard-king-1.jpg",
              "width": 1920,
              "height": 1080,
              "size": "LARGE",
              "unit": "PIXEL",
              "fileSize": 1800,
              "resolution": 300,
              "recordId": "RM-IMG-ITEM-001",
              "formatCode": "JPG"
            }
          ],
          "lastUpdated": "2023-12-01"
        }
      ],
      "extensions": {
        "additionalProp1": "Coffee/Tea Maker",
        "additionalProp2": "",
        "additionalProp3": ""
      }
    }
  ]
}

Response Parameters

Parameter	Type	Description	Example
contextCode	String	Context Code in DerbySoft's system.	DERBYDEMO
supplierCode	String	Supplier Code in DerbySoft's system.	DERBYDEMO
propertyCode	String	Property code provided by content suppliers, only the following characters are allowed. 1. Digits (0-9) 2. Uppercase letters (A-Z) 3. Hyphen ('-')	BONITAPROPERTY
operateStatus	String	Indicates the operational status of the property. Enum: [ ENABLED, PAUSED ]	ENABLED

Example Response

Success Response (HTTP Status 200)

{
    "data": {
        "contextCode": "derbydemo",
        "supplierCode": "DERBYHOTEL",
        "propertyCode": "derbydemo001",
        "operateStatus": "ENABLED"
    }
}

Error Response (HTTP Status 403)

{
    "error": {
        "code": "FORBIDDEN",
        "message": "Lack of permissions, please configure permissions."
    }
}

Error Response (HTTP Status 400)

{
    "error": {
        "code": "MissingField",
        "message": "Required request parameter 'contextCode' for method parameter type String is not present"
    }
}

Knowledge Base

Guestroom API

Introduction

Get Guestroom

API Endpoints & Methods

Headers

Query Parameters

Response Parameters

Example Response

Get Guestroom Content with {guestRoomCode}

API Endpoints & Methods

Headers

Query Parameters

Response Parameters

Example Response

POST Guestroom Content

API Endpoints & Methods

Headers

Query Parameters

Example Request

Response Parameters

Example Response

About Content Supplier API

Supplier API Documentation

Property API

Rateplan API

Appendix

Guestroom API

Introduction

Get Guestroom

API Endpoints & Methods

Headers

Query Parameters

Response Parameters

Example Response

Get Guestroom Content with {guestRoomCode}

API Endpoints & Methods

Headers

Query Parameters

Response Parameters

Example Response

POST Guestroom Content

API Endpoints & Methods

Headers

Query Parameters

Example Request

Response Parameters

Example Response

Related Articles:

About Content Supplier API

Supplier API Documentation

Property API

Rateplan API

Appendix