GET Property Content
Modified on: 2026-03-04 14:19
TABLE OF CONTENTS
- Purpose
- Property Content Request Schema
- Property Content Request Example
- Property Content Response Schema
- Property Content Response Examples
Purpose
Retrieve property-level content for a single hotel using the BTS-defined schema.
This endpoint is designed to support best-in-class content for business travel distribution. It allows distributors to build and maintain accurate hotel properties in their platforms using content sourced directly from hoteliers, normalized and curated by DerbySoft.
The endpoint provides a clean and reliable foundation for property creation and maintenance, ensuring consistent hotel information across distributor systems by using a modern and structured approach to organizing property data.
GET{endpoint}/property/{supplierId}/{hotelId}?distributorId={distributorId}&languageCode={languageCode} HTTP/1.1
URL:
Authorization: 53ac07777cdffac2d53000002d698728ce964432d7167596bc005c5fc
Accept-Encoding: gzip
Content-Encoding: gzip
Content-Type: application/json;charset=utf-8Property 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 | 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 |
Property Content Request Example
https://{enpoinrt}/contentv4/property/GOHOTEL/MARRIOTT-H01?distributorId=TEST01BPULLProperty Content Response Schema
Level | Field Name | Required | Data Type | Description | Example |
|---|---|---|---|---|---|
| 1 | hotelId | Y | string | Unique property identifier. | HTL123456 |
| 1 | hotelName | Y | string | Official hotel name. | Hotel Gran Via Barcelona |
| 1 | hotelStatusCode | n | enum | Operating status of the hotel using OTA_CodeType:"HST" | |
| 1 | languageCode | Y | string | Language for the associated property content in this message | EN-US |
| 1 | chainCode | N | string | Chain code. | MARRIOTT |
| 1 | chainName | N | string | Chain name | MARRIOTT |
| 1 | brandCode | N | string | Brand code. | WI |
| 1 | brandName | N | string | Brand name. | Westin |
| 1 | hotelDescription | Y | string | Official hotel description. | Located in dazzling downtown Shanghai two blocks from the vibrant promenade on the Bund waterfront The Westin Bund Center Shanghai is a conveniently situated 5 star hotel in a neighborhood of luxury brand shops and celebrated restaurants. Enjoy easy access to major business districts as well. While at the hotel, jump start your day in our beautiful heated pool or the WestinWORKOUT Fitness Studio. Enjoy delectable Eat Well breakfast buffets and surrender to pampering treatments in the ISpa Shanghai. Two architecturally dazzling 26 story towers with 568 hotel rooms and suites surround you in sumptuous style and 5 star amenities. Sink into a plush Westin Heavenly Bed, enjoy high tech amenities and superb views of the Huangpu River and the Bund or the Shanghai cityscape and Yu Garden. |
| 1 | star | N | decimal | Hotel start rating. | 4 |
| 1 | timeZone | N | string | timezone for the hotel. | GMT+8 |
| 1 | lastUpdate | n | dateTime | Date/timestamp of last update to data in the HotelInfo element | 2026-01-15T09:38:50.499Z |
| 1 | defaultCurrencyCode | N | enum | Default operational currency of the property ISO Code | CNY |
| 1 | preSellDate | n | date | The property pre sell date. | 2025-11-03 |
| 1 | totalRoomCount | N | intenger | Total number of rooms at the property | 438 |
| 1 | position | N | object | Geographical coordinates of the property. | |
| 2 | latitude | N | decimal | Latitude in decimal degrees. | 41.3851 |
| 2 | longitude | N | decimal | Longitude in decimal degrees. | 2.1734 |
| 1 | closedSeasons | C | array | Time period when the hotel is closed | 2016-01-22 |
| 2 | start | C | date | Starting date of closure (yyyy-mm-dd) | 2016-10-22 |
| 2 | end | C | date | Ending date of closure (yyyy-mm-dd) | 15/01/2026 |
| 1 | address | Y | object | Postal address of the property. | |
| 2 | addressLine | Y | array<string> | Street address line. | Bund Center, 88 Henan Central Road |
| 2 | countryCode | Y | string | Country name or ISO code. | CN |
| 2 | stateProv | N | string | State or province. | Shanghai |
| 2 | cityName | Y | string | City name. | shanghai |
| 2 | postalCode | N | string | Postal or ZIP code. | 200002 |
| 1 | contactInfos | N | array | List of contact details for the property. | |
| 2 | phones | N | array | ||
| 3 | countryAccessCode | c | interger | International country access identifier | 86 |
| 3 | areaCityCode | n | interger | Code assigned for phone numbes in a specific region, city or area | 21 |
| 3 | phoneNumber | c | interger | Telephone number | 63351999 |
| 3 | phoneLocationType | n | enum | Location of the phone see OTA Codes List (Appendix) | 4 |
| 2 | emails | N | array | ||
| 3 | C | string | Individual email address information | reservations@hotel.com | |
| 3 | emailType | n | enum | Defines the purpose of the email address see OTA Codes List (Appendix) OTA_CodeType "EAT" | 4 |
| 2 | URLs | N | array | Collection of website addresses | |
| 2 | acceptedPayments | N | array | ||
| 3 | CardTypeCode | c | enum | Payment card type code: AmericanExpress, BritishAirways, ContinentalAirlines, DeltaAirlines, DinersClub, DiscoverCard, Disney, Eurocard, Hilton, Hyatt, JapanCreditBureau, Marriott, Mastercard, RitzCarlton, SouthwestAirlines, StarwoodHotels, UnitedAirlines, USAirways, VISA | AmericanExpress |
| 3 | cardTypeDescription | N | string | Payment card type description | AmericanExpress |
| 1 | services | N | object | List of services, amenities or facilities offered by the property (e.g., airport shuttle, room service, Concierge, health club, pool ). | |
| 2 | amenities | N | array | ||
| 3 | Code | C | enum | Hotel amenity or service code under OTA_CodeType "HAC" (either this or BusinessServiceCode, will be sent) see OTA Codes List (Appendix) | 102 |
| 3 | codeDetail | N | string | Further detail about the meeting room amenity or service | Whirlpool |
| 3 | description | N | string | Human-readable service description. | Translation services desc |
| 3 | included | N | boolean | indicate if the servide its included, default value is false | FALSE |
| 3 | operationSchedules | N | array | Collection of operation times a | |
| 4 | start | C | date | Starting date of service availability | 2026-01-01 |
| 4 | end | C | date | Ending date of service availability | 2026-12-01 |
| 4 | operationTimes | N | array | Defines the hours of operation | |
| 5 | start | C | Time | Starting time of service availability | 7:00 |
| 5 | end | C | Time | Ending time of service availability | 11:00 |
| 4 | charges | N | array | Cost associated with an amenity or service | |
| 5 | amount | n | decimal | Service or amenity cost as a monetary amount | 250 |
| 5 | currencyCode | N | string | Currency code of amount | CNY |
| 5 | Percent | n | decimal | Service or amenity cost as a percentage of room rate | 10 |
| 5 | chargeUnit | n | enum | Unit for which the charge applies base on OTA_CodeType "CHG" | 7 |
| 5 | chargeFrequency | n | enum | Timeframe used to apply the charge during the course of the reservation OTA_CodeType "CHG" | 1 |
| 2 | businessServices | ||||
| 3 | Code | C | enum | Hotel amenity or service code under OTA_CodeType "HAC" (either this or BusinessServiceCode, will be sent) see OTA Codes List (Appendix) | 228 |
| 3 | codeDetail | N | string | Further detail about the meeting room amenity or service | Business center |
| 3 | description | N | string | Human-readable service description. | Translation services desc |
| 3 | included | N | boolean | indicate if the servide its included, default value is false | FALSE |
| 3 | operationSchedules | N | array | Collection of operation times a | |
| 4 | start | C | date | Starting date of service availability | 2026-01-01 |
| 4 | end | C | date | Ending date of service availability | 2026-12-01 |
| 4 | operationTimes | N | array | Defines the hours of operation | |
| 5 | start | C | Time | Starting time of service availability | 7:00 |
| 5 | end | C | Time | Ending time of service availability | 11:00 |
| 4 | charges | N | array | Cost associated with an amenity or service | |
| 5 | amount | n | decimal | Service or amenity cost as a monetary amount | 250 |
| 5 | currencyCode | N | string | Currency code of amount | CYN |
| 5 | Percent | n | decimal | Service or amenity cost as a percentage of room rate | 10 |
| 5 | chargeUnit | n | enum | Unit for which the charge applies base on OTA_CodeType "CHG" | 7 |
| 5 | chargeFrequency | n | enum | Timeframe used to apply the charge during the course of the reservation OTA_CodeType "CHG" | 1 |
| 2 | restaurantInfo | n | object | ||
| 3 | quantity | C | intenger | number of restaurants at the property | 5 |
| 3 | restaurants | N | array | Specific restaurant information | |
| 4 | id | N | string | Restaurant ID in supplier system | 548762 |
| 4 | name | N | string | Name of the restaurant | Prego |
| 4 | offers breakfast | N | boolean | Restaurant serves breakfast | TRUE |
| 4 | offersLunch | N | boolean | Restaurant serves lunch | FALSE |
| 4 | offersDinner | N | boolean | Restaurant serves dinner | TRUE |
| 4 | offersBrunch | N | boolean | Restaurant serves brunch | FALSE |
| 4 | proximityCode | N | enum | Proximity of restaurant to hotel using OTA_CodeType "PRX" see OTA Codes List (Appendix) | 1 |
| 2 | meetingRoomInfo | N | object | Collection of meeting rooms that are within the hotel | |
| 3 | quantity | N | intenger | number of meeting rooms at the property | 19 |
| 3 | meetingRooms | N | array | Specific restaurant information | |
| 4 | name | N | string | Meeting room Name | Liberty loft |
| 4 | id | n | string | Unique ID for the meeting room | 1597842 |
| 4 | amenities | N | array | Collection of information about meeting room amenities and services | |
| 5 | code | n | string | Amenities or services available for any of the meeting rooms using OTA_CodeType: "MRC" | 17 |
| 5 | codeDetail | n | string | Further detail about the meeting room amenity or service | High speed internet access |
| 5 | quantity | n | intenger | Quantity of the meeting room amenity | 23 |
| 4 | Capacities | n | array | Information about the amount of usable meeting space at a hotel | |
| 5 | format | n | enum | Meeting room seating format code using OTA_CodeType: "MRC" | 1 |
| 5 | MaxOccupancy | n | intenger | Maximum number of people the meeting room can accommodate for specific seeting | 100 |
| 4 | Dimenson | n | object | Dimensions of the meeting room | |
| 5 | Area | n | decimal | Total area of meeting room | 600 |
| 5 | Height | n | decimal | Height of meeting room ceilings | 30 |
| 5 | lenght | n | decimal | Length of meeting room | 20 |
| 5 | width | n | decimal | Width of meeting room | 3 |
| 5 | unitOfMeasure | n | decimal | Unit of measure for dimensions using OTA_CodeType: "UOM" | |
| 2 | policyInfo | N | object | General property-level policy information (house rules). | |
| 3 | checkInTime | N | time | Specifies the earliest time a guest can check-in. | 15:00 |
| 3 | checkOutTime | N | time | Specifies the latest time a guest can check-out. | 12:00 |
| 3 | petsAllowedCode | N | enum | Specifies at a high level the pet policy at the hotel: Pets Allowed, Pets Not Allowed, Assistive Animals Only, Pets By Arrangements | Pets Not Allowed |
| 2 | loyaltyPrograms | N | array | Collection of loyalty programs this hotel participates in | |
| 3 | programName | C | string | Name of the loyalty program | travelSectorTest Name |
| 3 | travelSector | C | enum | Travel sector to which the loyalty program applies see OTA Codes List Appendix) | travelSectorTest" |
| 3 | programDescription | N | string | Text description of the loyalty program | travelSectorTest description |
Property Content Response Examples
Success Response (HTTP Status 200)
{
"hotelId": "MARRIOTT-H01",
"hotelName": "The Westin Bund Center, Shanghai",
"hotelStatusCode": "OPEN",
"languageCode": "EN-US",
"chainCode": "MARRIOTT",
"chainName": "MARRIOTT",
"brandCode": "WI",
"brandName": "Westin",
"hotelDescription": "Located in dazzling downtown Shanghai two blocks from the vibrant promenade on the Bund waterfront The Westin Bund Center Shanghai is a conveniently situated 5 star hotel in a neighborhood of luxury brand shops and celebrated restaurants. Enjoy easy access to major business districts as well. While at the hotel, jump start your day in our beautiful heated pool or the WestinWORKOUT Fitness Studio. Enjoy delectable Eat Well breakfast buffets and surrender to pampering treatments in the ISpa Shanghai. Two architecturally dazzling 26 story towers with 568 hotel rooms and suites surround you in sumptuous style and 5 star amenities. Sink into a plush Westin Heavenly Bed, enjoy high tech amenities and superb views of the Huangpu River and the Bund or the Shanghai cityscape and Yu Garden.",
"star": "4.5",
"timeZone": "GMT+8",
"lastUpdateTime": "2026-01-15T09:38:50.499Z",
"defaultCurrencyCode": "CNY",
"preSellDate": "2025-11-03",
"totalRoomCount": 438,
"position": {
"latitude": "31.2321462",
"longitude": "121.4865195"
},
"closeSeasons": [
{
"start": "2016-01-22",
"end": "2016-10-22"
},
{
"start": "2016-11-22",
"end": "2017-06-22"
}
],
"address": {
"addressLine": "Bund Center, 88 Henan Central Road",
"countryCode": "CN",
"stateProv": "Shanghai",
"cityName": "Shanghai",
"postalCode": "200002"
},
"contactInfos": [
{
"phones": [
{
"countryAccessCode": "86",
"areaCityCode": "21",
"phoneNumber": "63351888",
"phoneLocationType": "4"
},
{
"countryAccessCode": "86",
"areaCityCode": "21",
"phoneNumber": "63352888",
"phoneLocationType": "4"
}
],
"emails": [
{
"email": "rsvns-shanghai@westin.com",
"emailType": "4"
}
],
"urls": [
"https://www.marriott.com.cn/default.mi",
"https://www.marriott.com.cn/reservation/lookupReservation.mi"
]
}
],
"acceptedPayments": [
{
"cardTypeCode": "AmericanExpress",
"cardTypeDescription": "AmericanExpress"
},
{
"cardTypeCode": "JapanCreditBureau",
"cardTypeDescription": "JapanCreditBureau"
},
{
"cardTypeCode": "Other"
},
{
"cardTypeCode": "Visa"
},
{
"cardTypeCode": "DiscoverCard"
},
{
"cardTypeCode": "Union Pay"
},
{
"cardTypeCode": "Mastercard"
},
{
"cardTypeCode": "DinersClub"
}
],
"services": {
"amenities": [
{
"code": "37"
},
{
"code": "133"
},
{
"code": "165"
},
{
"code": "20"
},
{
"code": "187"
},
{
"code": "170",
"codeDetail": "1"
},
{
"code": "116",
"codeDetail": "Yes"
},
{
"code": "64",
"codeDetail": "Complimentary"
},
{
"code": "145"
},
{
"code": "137"
},
{
"code": "146"
},
{
"code": "22"
},
{
"code": "129"
},
{
"code": "78"
},
{
"code": "26",
"codeDetail": "On Property"
},
{
"code": "100"
},
{
"code": "149"
},
{
"code": "96"
},
{
"code": "148"
},
{
"code": "132"
},
{
"code": "39",
"codeDetail": "On Property"
},
{
"code": "168"
},
{
"code": "152"
},
{
"code": "77"
},
{
"code": "150"
},
{
"code": "151"
},
{
"code": "7",
"codeDetail": "Nearby"
},
{
"code": "15"
},
{
"code": "15"
},
{
"code": "157",
"codeDetail": "Buffet breakfast detal",
"description": "Buffet breakfast desc",
"included": false,
"operationSchedules": [
{
"start": "2026-01-01",
"end": "2026-12-01",
"operationTimes": [
{
"start": "07:00",
"end": "13:00"
},
{
"start": "16:00",
"end": "23:00"
}
],
"charges": [
{
"amount": "254.00",
"currencyCode": "CNY",
"chargeUnit": "7",
"chargeFrequency": "1"
}
]
},
{
"start": "2027-01-01",
"end": "2027-12-01",
"operationTimes": [
{
"start": "07:00",
"end": "13:00"
},
{
"start": "16:00",
"end": "23:00"
}
],
"charges": [
{
"currencyCode": "CNY",
"percent": "10",
"chargeUnit": "7",
"chargeFrequency": "1"
}
]
}
]
},
{
"code": "104"
},
{
"code": "352"
},
{
"code": "360"
},
{
"code": "361"
},
{
"code": "364"
},
{
"code": "367"
},
{
"code": "365"
},
{
"code": "366"
},
{
"code": "92"
},
{
"code": "354"
},
{
"code": "50",
"codeDetail": "Daily"
},
{
"code": "93"
}
],
"businessServices": [
{
"code": "49"
},
{
"code": "70",
"codeDetail": "Yes"
},
{
"code": "102",
"codeDetail": "Translation services detal",
"description": "Translation services desc",
"included": false,
"operationSchedules": [
{
"start": "2026-01-01",
"end": "2026-12-01",
"operationTimes": [
{
"start": "07:00",
"end": "13:00"
},
{
"start": "16:00",
"end": "23:00"
}
],
"charges": [
{
"amount": "254.00",
"currencyCode": "CNY",
"chargeUnit": "7",
"chargeFrequency": "1"
}
]
},
{
"start": "2027-01-01",
"end": "2027-12-01",
"operationTimes": [
{
"start": "07:00",
"end": "13:00"
},
{
"start": "16:00",
"end": "23:00"
}
],
"charges": [
{
"currencyCode": "CNY",
"percent": "10",
"chargeUnit": "7",
"chargeFrequency": "1"
}
]
}
]
}
],
"restaurantInfo": {
"quantity": 100,
"restaurants": [
{
"id": "5965872",
"name": "Prego",
"offersBreakfast": false,
"offersLunch": true,
"offersDinner": true,
"offersBrunch": false,
"proximityCode": "1"
},
{
"id": "5965873",
"name": "The Crystal Garden",
"offersBreakfast": false,
"offersLunch": true,
"offersDinner": false,
"offersBrunch": false,
"proximityCode": "1"
},
{
"id": "5965874",
"name": "The Stage",
"offersBreakfast": true,
"offersLunch": true,
"offersDinner": true,
"offersBrunch": false,
"proximityCode": "1"
},
{
"id": "5965875",
"name": "Daily Treats",
"offersBreakfast": true,
"offersLunch": true,
"offersDinner": false,
"offersBrunch": false,
"proximityCode": "1"
}
]
},
"meetingRoomInfo": {
"quantity": 19,
"meetingRooms": [
{
"name": "Liberty Loft",
"id": "5965872",
"amenities": [
{
"code": "93",
"codeDetail": "1",
"quantity": 23
},
{
"code": "92",
"codeDetail": "2",
"quantity": 33
}
],
"capacities": [
{
"format": "1",
"maxOccupancy": 100
},
{
"format": "3",
"maxOccupancy": 150
}
],
"dimension": {
"area": "600",
"height": "30",
"length": "30",
"width": "20",
"unitOfMeasure": 3
}
}
]
}
},
"policyInfo": {
"checkInTime": "15:00:00",
"checkOutTime": "12:00:00",
"petsAllowedCode": "Pets Not Allowed"
},
"loyaltyPrograms": [
{
"programName": "travelSectorTest Name",
"travelSector": "travelSectorTest",
"programDescription": "travelSectorTest description"
}
]
}Error Response (HTTP Status 401)
{"error":"Invalid API key in request"}Error Response (HTTP Status 404) for unknown propertyCode (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.