API Objects

string

Maximum number of guests permitted in the room. {"number_of_adults": <num_adult>, "number_of_children": <num_child>}.

Example: {"number_of_adults": 3, "number_of_children": 2 }.  

Provide when all flags below are true:

• room_type_details

 Area of room in given units. If given, both value and unit are required.

Provide when all flags below are true:

• room_type_details 

A list of one or more possible configurations. 

In order for a bed configuration to be valid, at least one element must exist in either the standard array or custom array. 
Two or more configurations mean that the room could be configured to contain either (any) of these set ups. 

For example, the following snippet illustrates how to represent two bed configurations, either one king bed OR two double beds:

"bed_configurations": [
  { "standard": [ { "count": 1, "code": 3 } ] },
  { "standard": [ { "count": 2, "code": 1 } ] }
]

The following snippet illustrates how to represent one bed configuration, with a crib AND a custom bunk bed:

"bed_configurations": [
  { "standard": [ { "count": 1, "code": 900302 } ],
    "custom": [ { "count": 1, "name": "Bunk bed"} ] }
]

Specify the bed types for a room, and if needed multiple bed configurations available. The type of bed provided is based on OpenTravel BED code table: 

Provide when all flags below are true:

• room_type_details

A list of one or more possible extra bed configurations. 
Extra bed configurations are configurations of extra beds that can physically be added to the RoomType for the guest on request. This service may or may not be included in the price of this room. 

In order for an extra bed configuration to be valid, at least one element must exist in either the standard array or custom array. 
Two or more configurations mean that the room could be configured to contain either (any) of these set ups.

For examples, see bed_configurations.

Provide when all flags below are true:

• room_type_details

Choose from available OpenTravel codes for Room View Type when available: 

The standard room_view_type will be returned as an integer array. If a room_view_type does not exist in the table above, then the Connectivity Partner may provide their own values in the "custom" field as a string array. Return "custom":[ ] if no custom list exists.

Example: { "standard": [1,2,25], "custom": ["my own view of the dunes"] }

Example: {"standard": [2, 25], "custom": [ ]}

Choose from available codes for accessibility features below:

The standard accessibility features will be returned as an integer array. If an accessibility feature does not exist in the table above, then the Connectivity Partner may provide their own values in the "custom" field as a string array. Return "custom":[ ] if no custom list exists. We encourage you to avoid custom accesibility features, as this may hinder international rollout, and not allow display of standard accessibility icons for travelers. 

Example: {"standard": [900504, 900505], "custom": [ ]}

• smoking
• non_smoking

We also capture hotel_smoking_policy in HotelDetails. The options specified here should not invalidate information at the Hotel level. In the case of a mismatch, Tripadvisor will not display this information.

Choose from available OpenTravel codes for meal plans (MPT):

The standard meal_plan will be returned as an integer array. If a meal_plan does not exist in the table above, then the Connectivity Partner may provide their own values in the "custom" field as a string array. Return "custom":[ ] if no custom list exists.

Example: { "standard": [1,2], "custom": ["All you can eat", "Special breakfast"] }

Example: {"standard": [2, 4], "custom": [ ]}

Provide when all flags below are true:

• room_rate_details

The number of rooms remaining / available at a given hotel for a given roomtype at a given price. This number should be >0.