GET Room Content
Modified on: 2026-03-10 10:30
TABLE OF CONTENTS
- Purpose
- Endpoint
- Room Content Request Schema
- Room Content Request Example
- Room Content Response Schema
- Room Content Response Examples
Purpose
Retrieve room-type content for a single hotel using the BTS-defined schema.
This endpoint returns all room definitions associated with the specified hotel, structured in a clear and consistent format. It is intended to help distributors build and maintain accurate room content by consuming normalized, hotel-sourced room information that is aligned with business travel requirements.
Endpoint
GET {endpoint}/rooms/{supplierId}/{hotelId}?distributorId={distributorId}&languageCode={languageCode}/hotel/{supplierId}/{hotelId}?distributorId={distributorId} ten HTTP/1.1
URL:
Authorization: 53ac07777cdffac2d53000002d698728ce964432d7167596bc005c5fc
Accept-Encoding: gzip
Content-Encoding: gzip
Content-Type: application/json;charset=utf-8Room Content Request Schema
Request(METHOD: GET) | |||||
|---|---|---|---|---|---|
| Request Part | Field Name | Required | Data type | Description | Example |
| Path | supplierId | Y | string | Supplier ID in DerbySoft's system | Marriott |
| Path | hotelId | Y | string | Hotel Supplier's Hotel ID | GATHI |
| Query | distributorId | Y | string | The ID of distributor in DerbySoft's system | Engine |
| Query | languageCode | N | enum | Language for the requested hotel descriptive information, following the "ISO 639 " 2-letter language code that conforms to ISO 639, followed by a hyphen and a two-letter country code that conforms to ISO 3166 | EN-US |
Room Content Request Example
https:// {enpoinrt} /contentv4/rooms/GOHOTEL/MARRIOTT-H02?distributorId=TEST01BPULLRoom Content Response Schema
Level | Field Name | Required | Data Type | Description | Example |
|---|---|---|---|---|---|
| 1 | HotelId | Y | string | Reference to the hotel associated with this room type. | HTL123456 |
| 1 | Rooms | Y | array | ||
| 2 | RoomId | Y | string | Unique room type code within the hotel. | DLX_KING |
| 2 | RoomName | Y | string | Room type name. | Deluxe, 1 King |
| 2 | RoomDescription | N | string | Text description of the room. | Deluxe, 1 King, Bathrooms: 1.5, Mini fridge, 72sqm/775sqft, Living/sitting area, Separate living room, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 37in/94cm LCD TV |
| 2 | NonSmoking | N | boolean | Indicates if the room is non-smoking. | true |
| 2 | Occupancy | N | object | Occupancy information for the room type. | |
| 3 | MaxOccupancy | N | integer | Maximum total occupancy allowed. | 3 |
| 3 | MaxAdult | N | integer | Maximum number of adults allowed. | 2 |
| 3 | MaxChild | N | integer | Maximum number of children allowed. | 1 |
| 2 | TypeRooms | N | array | Room configuration, including bed setup. | |
| 3 | Category | N | enum | Guest room category base on OTA_CodeType "SEG" | 1 |
| 3 | Size | N | decimal | Number of square units that defines the size of a room type | 60 |
| 3 | unitOfMeasure | N | enum | Unit of measure base on OTA_CodeType "UOM" | 14 |
| 3 | view | N | enum | Room view base on OTA_CodeType "RVT" | 3 |
| 3 | Beds | N | array | List of bed configurations. | |
| 4 | BedType | C | enum | Bed type code under OTA_CodeType "BED" | 2 |
| 4 | Count | C | integer | Number of beds of this type. | 1 |
| 3 | Amenities | N | array | Room-level amenities. | |
| 4 | AmenityCode | C | string | Room amenity code. | 69 |
| 4 | AmenityDescription | C | string | Description of the amenity. | Free Wi-Fi |
| 3 | accessibleFeatures | N | array | ||
| 4 | code | C | enum | Guest room accessibility feature code using OTA_CodeType "PHY" | 1 |
| 4 | codeDetail | N | string | Further detail about the feature | Americans with Disabilities Act (ADA) compliance |
| 3 | securityFeatures | N | array | ||
| 4 | code | C | enum | Guest room accessibility feature code using OTA_CodeType "PHY" | 19 |
| 4 | codeDetail | N | string | Further detail about the feature | Emergency lighting |
Room Content Response Examples
Success Response (HTTP Status 200)
{
"hotelId": "BTS-Test",
"rooms": [
{
"roomId": "CLEX",
"roomName": "Executive Suite King Bed, Club lounge access, 1 Bedroom Executive Suite, 1 King, Bathrooms: 1.5",
"roomDescription": "Executive Suite, 1 King, Bathrooms: 1.5, Mini fridge, 72sqm/775sqft, Living/sitting area, Separate living room, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 37in/94cm LCD TV",
"nonSmoking": true,
"occupancy": {
"maxOccupancy": 3,
"maxAdult": 3,
"maxChild": 2
},
"typeRooms": [
{
"category": "1",
"size": "60.00",
"unitOfMeasure": "14",
"view": "3",
"beds": [
{
"bedType": "2",
"count": 1
},
{
"bedType": "3",
"count": 1
}
],
"amenities": [
{
"amenityCode": "69",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "25",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "26",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "18",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "19",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "150",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "132",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "242"
},
{
"amenityCode": "155"
},
{
"amenityCode": "2"
},
{
"amenityCode": "233"
},
{
"amenityCode": "3"
},
{
"amenityCode": "147"
},
{
"amenityCode": "103"
},
{
"amenityCode": "5"
},
{
"amenityCode": "138"
},
{
"amenityCode": "216"
},
{
"amenityCode": "80"
},
{
"amenityCode": "228"
},
{
"amenityCode": "92"
},
{
"amenityCode": "50"
},
{
"amenityCode": "94"
},
{
"amenityCode": "85"
},
{
"amenityCode": "10"
}
],
"accessibleFeatures": [
{
"code": "1",
"codeDetail": "Americans with Disabilities Act (ADA) compliance"
},
{
"code": "2",
"codeDetail": "Audible emergency alarm for sight impaired guest"
}
],
"securityFeatures": [
{
"code": "2",
"codeDetail": "Address of nearest police station"
},
{
"code": "19",
"codeDetail": "Emergency lighting"
}
]
}
]
},
{
"roomId": "DKNG",
"roomName": "Crown Deluxe King Bed, Guest room, 1 King, City view, Crown Tower",
"roomDescription": "Crown Deluxe King, 1 King, Mini fridge, 32sqm/344sqft-37sqm/398sqft, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 37in/94cm LCD TV",
"nonSmoking": true,
"occupancy": {
"maxOccupancy": 2
},
"typeRooms": [
{
"beds": [
{
"count": 1
}
],
"amenities": [
{
"amenityCode": "69",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "25"
},
{
"amenityCode": "26"
},
{
"amenityCode": "18"
},
{
"amenityCode": "19"
},
{
"amenityCode": "150"
},
{
"amenityCode": "132"
},
{
"amenityCode": "242"
},
{
"amenityCode": "155"
},
{
"amenityCode": "2"
},
{
"amenityCode": "233"
},
{
"amenityCode": "3"
},
{
"amenityCode": "147"
},
{
"amenityCode": "103"
},
{
"amenityCode": "5"
},
{
"amenityCode": "138"
},
{
"amenityCode": "216"
},
{
"amenityCode": "80"
},
{
"amenityCode": "228"
},
{
"amenityCode": "92"
},
{
"amenityCode": "50"
},
{
"amenityCode": "94"
},
{
"amenityCode": "85"
},
{
"amenityCode": "10"
}
]
}
]
},
{
"roomId": "DLAN",
"roomName": "Crown Deluxe Twin Bed, Guest room, 2 Twin/Single Bed(s), City view, Crown Tower",
"roomDescription": "Crown Deluxe Twin, 2 Twin/Single Bed(s), Mini fridge, 32sqm/344sqft-37sqm/398sqft, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 37in/94cm LCD TV",
"nonSmoking": true,
"occupancy": {
"maxOccupancy": 2
},
"typeRooms": [
{
"beds": [
{
"count": 2
}
],
"amenities": [
{
"amenityCode": "69",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "25"
},
{
"amenityCode": "26"
},
{
"amenityCode": "18"
},
{
"amenityCode": "19"
},
{
"amenityCode": "150"
},
{
"amenityCode": "132"
},
{
"amenityCode": "242"
},
{
"amenityCode": "155"
},
{
"amenityCode": "2"
},
{
"amenityCode": "233"
},
{
"amenityCode": "3"
},
{
"amenityCode": "147"
},
{
"amenityCode": "103"
},
{
"amenityCode": "5"
},
{
"amenityCode": "138"
},
{
"amenityCode": "216"
},
{
"amenityCode": "80"
},
{
"amenityCode": "228"
},
{
"amenityCode": "92"
},
{
"amenityCode": "50"
},
{
"amenityCode": "94"
},
{
"amenityCode": "85"
},
{
"amenityCode": "10"
}
]
}
]
},
{
"roomId": "EKNG",
"roomName": "Grand Deluxe King Bed, Guest room, 1 King, City view, Grand Tower",
"roomDescription": "Grand Deluxe King, 1 King, Mini fridge, 38sqm/409sqft-43sqm/463sqft, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 37in/94cm LCD TV",
"nonSmoking": true,
"occupancy": {
"maxOccupancy": 2
},
"typeRooms": [
{
"beds": [
{
"count": 1
}
],
"amenities": [
{
"amenityCode": "69",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "25"
},
{
"amenityCode": "26"
},
{
"amenityCode": "18"
},
{
"amenityCode": "19"
},
{
"amenityCode": "150"
},
{
"amenityCode": "132"
},
{
"amenityCode": "242"
},
{
"amenityCode": "155"
},
{
"amenityCode": "2"
},
{
"amenityCode": "233"
},
{
"amenityCode": "3"
},
{
"amenityCode": "147"
},
{
"amenityCode": "103"
},
{
"amenityCode": "5"
},
{
"amenityCode": "138"
},
{
"amenityCode": "216"
},
{
"amenityCode": "80"
},
{
"amenityCode": "228"
},
{
"amenityCode": "92"
},
{
"amenityCode": "50"
},
{
"amenityCode": "94"
},
{
"amenityCode": "85"
},
{
"amenityCode": "10"
}
]
}
]
},
{
"roomId": "EXDX",
"roomName": "Grand Deluxe Twin Bed, Guest room, 2 Twin/Single Bed(s), City view, Grand Tower",
"roomDescription": "Grand Deluxe Twin, 2 Twin/Single Bed(s), Mini fridge, 38sqm/409sqft-43sqm/463sqft, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 37in/94cm LCD TV",
"nonSmoking": true,
"occupancy": {
"maxOccupancy": 2
},
"typeRooms": [
{
"beds": [
{
"count": 2
}
],
"amenities": [
{
"amenityCode": "69",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "25"
},
{
"amenityCode": "26"
},
{
"amenityCode": "18"
},
{
"amenityCode": "19"
},
{
"amenityCode": "150"
},
{
"amenityCode": "132"
},
{
"amenityCode": "242"
},
{
"amenityCode": "155"
},
{
"amenityCode": "2"
},
{
"amenityCode": "233"
},
{
"amenityCode": "3"
},
{
"amenityCode": "147"
},
{
"amenityCode": "103"
},
{
"amenityCode": "5"
},
{
"amenityCode": "138"
},
{
"amenityCode": "216"
},
{
"amenityCode": "80"
},
{
"amenityCode": "228"
},
{
"amenityCode": "92"
},
{
"amenityCode": "50"
},
{
"amenityCode": "94"
},
{
"amenityCode": "85"
},
{
"amenityCode": "10"
}
]
}
]
},
{
"roomId": "LUXR",
"roomName": "Grand Studio King Bed, 1 Bedroom Junior Suite, 1 King, City view, Grand Tower",
"roomDescription": "Grand Studio, 1 King, Mini fridge, 44sqm/473sqft-54sqm/581sqft, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 37in/94cm LCD TV",
"nonSmoking": true,
"occupancy": {
"maxOccupancy": 3
},
"typeRooms": [
{
"beds": [
{
"count": 1
}
],
"amenities": [
{
"amenityCode": "69",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "25"
},
{
"amenityCode": "26"
},
{
"amenityCode": "18"
},
{
"amenityCode": "19"
},
{
"amenityCode": "150"
},
{
"amenityCode": "132"
},
{
"amenityCode": "242"
},
{
"amenityCode": "155"
},
{
"amenityCode": "2"
},
{
"amenityCode": "233"
},
{
"amenityCode": "3"
},
{
"amenityCode": "147"
},
{
"amenityCode": "103"
},
{
"amenityCode": "5"
},
{
"amenityCode": "138"
},
{
"amenityCode": "216"
},
{
"amenityCode": "80"
},
{
"amenityCode": "228"
},
{
"amenityCode": "92"
},
{
"amenityCode": "50"
},
{
"amenityCode": "94"
},
{
"amenityCode": "85"
},
{
"amenityCode": "10"
}
]
}
]
},
{
"roomId": "OBRS",
"roomName": "Crown Studio Twin Bed, Larger Studio, 2 Twin/Single Bed(s), City view, Crown Tower",
"roomDescription": "Crown Studio Twin, 2 Twin/Single Bed(s), Mini fridge, 42sqm/452sqft-49sqm/527sqft, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 37in/94cm LCD TV",
"nonSmoking": true,
"occupancy": {
"maxOccupancy": 3
},
"typeRooms": [
{
"beds": [
{
"count": 2
}
],
"amenities": [
{
"amenityCode": "69",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "25"
},
{
"amenityCode": "26"
},
{
"amenityCode": "18"
},
{
"amenityCode": "19"
},
{
"amenityCode": "150"
},
{
"amenityCode": "132"
},
{
"amenityCode": "242"
},
{
"amenityCode": "155"
},
{
"amenityCode": "2"
},
{
"amenityCode": "233"
},
{
"amenityCode": "3"
},
{
"amenityCode": "147"
},
{
"amenityCode": "103"
},
{
"amenityCode": "5"
},
{
"amenityCode": "138"
},
{
"amenityCode": "216"
},
{
"amenityCode": "80"
},
{
"amenityCode": "228"
},
{
"amenityCode": "92"
},
{
"amenityCode": "50"
},
{
"amenityCode": "94"
},
{
"amenityCode": "85"
},
{
"amenityCode": "10"
}
]
}
]
},
{
"roomId": "OBST",
"roomName": "Westin Workout King Bed, Larger Studio, 1 King, City view, Crown Tower",
"roomDescription": "Westin Workout room, 1 King, Mini fridge, 49sqm/527sqft, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 37in/94cm LCD TV",
"nonSmoking": true,
"occupancy": {
"maxOccupancy": 3
},
"typeRooms": [
{
"beds": [
{
"count": 1
}
],
"amenities": [
{
"amenityCode": "69",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "25"
},
{
"amenityCode": "26"
},
{
"amenityCode": "18"
},
{
"amenityCode": "19"
},
{
"amenityCode": "150"
},
{
"amenityCode": "132"
},
{
"amenityCode": "242"
},
{
"amenityCode": "155"
},
{
"amenityCode": "2"
},
{
"amenityCode": "233"
},
{
"amenityCode": "3"
},
{
"amenityCode": "147"
},
{
"amenityCode": "103"
},
{
"amenityCode": "5"
},
{
"amenityCode": "138"
},
{
"amenityCode": "216"
},
{
"amenityCode": "80"
},
{
"amenityCode": "228"
},
{
"amenityCode": "92"
},
{
"amenityCode": "50"
},
{
"amenityCode": "94"
},
{
"amenityCode": "85"
},
{
"amenityCode": "10"
}
]
}
]
},
{
"roomId": "ONBE",
"roomName": "Crown Studio King Bed, Larger Studio, 1 King, City view, Crown Tower",
"roomDescription": "Crown Studio King, 1 King, Mini fridge, 42sqm/452sqft-49sqm/527sqft, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 37in/94cm LCD TV",
"nonSmoking": true,
"occupancy": {
"maxOccupancy": 3
},
"typeRooms": [
{
"beds": [
{
"count": 1
}
],
"amenities": [
{
"amenityCode": "69",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "25"
},
{
"amenityCode": "26"
},
{
"amenityCode": "18"
},
{
"amenityCode": "19"
},
{
"amenityCode": "150"
},
{
"amenityCode": "132"
},
{
"amenityCode": "242"
},
{
"amenityCode": "155"
},
{
"amenityCode": "2"
},
{
"amenityCode": "233"
},
{
"amenityCode": "3"
},
{
"amenityCode": "147"
},
{
"amenityCode": "103"
},
{
"amenityCode": "5"
},
{
"amenityCode": "138"
},
{
"amenityCode": "216"
},
{
"amenityCode": "80"
},
{
"amenityCode": "228"
},
{
"amenityCode": "92"
},
{
"amenityCode": "50"
},
{
"amenityCode": "94"
},
{
"amenityCode": "85"
},
{
"amenityCode": "10"
}
]
}
]
},
{
"roomId": "ROYS",
"roomName": "Crown/Bund/SHA/ChinaSuite, Club lounge access, 1 Bedroom Residential Suite, 1 King, City view",
"roomDescription": "Signature Suite, 1 King, Mini fridge, 107sqm/1151sqft-157sqm/1689sqft, Living/sitting area, Dining area, Separate living room, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 37in/94cm LCD TV",
"nonSmoking": true,
"occupancy": {
"maxOccupancy": 3
},
"typeRooms": [
{
"beds": [
{
"count": 1
}
],
"amenities": [
{
"amenityCode": "69",
"amenityDescription": "All Rooms/Suites"
},
{
"amenityCode": "25"
},
{
"amenityCode": "26"
},
{
"amenityCode": "18"
},
{
"amenityCode": "19"
},
{
"amenityCode": "150"
},
{
"amenityCode": "132"
},
{
"amenityCode": "242"
},
{
"amenityCode": "155"
},
{
"amenityCode": "2"
},
{
"amenityCode": "233"
},
{
"amenityCode": "3"
},
{
"amenityCode": "147"
},
{
"amenityCode": "103"
},
{
"amenityCode": "5"
},
{
"amenityCode": "138"
},
{
"amenityCode": "216"
},
{
"amenityCode": "80"
},
{
"amenityCode": "228"
},
{
"amenityCode": "92"
},
{
"amenityCode": "50"
},
{
"amenityCode": "94"
},
{
"amenityCode": "85"
},
{
"amenityCode": "10"
}
]
}
]
}
]
}Error Response (HTTP Status 401)
{"error":"Invalid API key in request"}Error Response (HTTP Status 404) for unknown hotelCode (recommended)
{
"errorCode": "HotelNotFound",
"errorMessage": "Hotel[GOHOTEL:MARRIOTT-H02 has no access permission] not found."
}Did you find it helpful? Yes No
Send feedbackSorry we couldn't be helpful. Help us improve this article with your feedback.