Standard Objects

The Metadata Push and Metadata Audit APIs use these objects in multiple places.

Status

Bedtype

Amenity

Image

URL

Rateplan

Field/Object	Datatype	Required	Description
name	String	Yes	The name of the rateplan.
code	String	Yes	A code provided by Hotel Trader identifies this rateplan. It's unique for each rateplan for a property and is used while sending availability and rate information to the client.
currency	String	Yes	The currency used by the rateplan. Corresponds to the Currency standard object.
mealplan	Object	Yes	Mealplan option for this rateplan. It holds meal plan-related data.
shortDescription	String	Yes	A short description of the rateplan.
detailDescription	String	No	A detailed description of the rateplan.
commissionable	Boolean	No	If true, all rates sent to the client are commissionable, for this rateplan and the rates being supplied include the commission paid to the client.
commissionType	String	No	Describes the type of commission. Possible values: PERCENT, FIXED, HYBRID. Mandatory if commissionable is true.
commissionAmount	Float	Yes	This is the fixed commission amount that the client shall receive for every reservation. Applicable only if commissionable is true.
commissionPercent	Float	Yes	This is the commission percentage that the client shall receive for every reservation. Applicable only if commissionable is true.
comments	String	No	Additional notes related to this rateplan.
cancellationPolicyCode	String	Yes	The default cancellation policy code associated with the rateplan. The cancellationPolicy object contains the rateplan cancellation policy definition and is sent in a separate message to the client. See here for more details.
seasonalPolicies	Array	No	A list of seasonal policies (overrides) associated with the rateplan based on date range. Each seasonal policy includes: name, code, startDate and endDate.
isTaxInclusive	Boolean	Yes	Indicates whether the taxes are included in the price.
isRefundable	Boolean	Yes	Indicates whether rateplan is refundable.
isPromo	Boolean	Yes	Indicates whether this rateplan is a promo on top of another base rateplan.
rateplanType	Array	Yes	This field can have multiple values from one of the following: Enum: B2B_Package, B2B_Room_Only, B2C_Package, B2B_Room_Only. Null value indicates no distribution limitations.
destinationExclusive	Array	No	List of Destinations for which the distribution is exclusive. This is just the supplementary data. Null value indicates no distribution limitations.
destinationRestriction	Array	No	List of Destinations for which the distribution is restricted. This is just the supplementary data. Null value indicates no distribution limitations.

Mealplan

Field/Object	Datatype	Required	Description
mealplanCode	String	Yes	A unique identifier for the meal plan. Possible value: BI, LI, DI, AI, None
mealplanName	String	Yes	Name of the mealplan option.
mealplanDescription	String	Yes	A more detailed description of the meal plan.

Destination

Field/Object	Datatype	Required	Description
name	String	Yes	Name of the destination.
code	String	Yes	Country or Region Code as follows: Country: ISO 3166 Codes Region Codes: EMEA (Europe, the Middle East and Africa) NA (North America) LATAM (Latin America) APAC (Asia-Pacific)
type	String	Yes	Enum: COUNTRY, REGION

Seasonal Policy

Field/Object	Datatype	Required	Description
name	String	Yes	Name of the cancellation policy
code	String	Yes	The cancellation policy code is the unique identifier for the policy.
startDate	String	Yes	Start date for the cancellation policy in YYYY-MM-DD format (inclusive).
endDate	String	Yes	End date for the cancellation policy in YYYY-MM-DD format. (inclusive).

Roomtype

Field	Datatype	Required	Description
name	String	Yes	The name of the roomtype.
code	String	Yes	A code provided by Hotel Trader identifies this roomtype. This code is unique for each roomtype for a property. This code is used while sending availability and rate information to the client.
shortDescription	String	Yes	A short description of this roomtype.
longDescription	String	No	A long description of this roomtype. This field is sent to the client on an as-approved basis.
maxAdultOccupancy	Integer	Yes	The maximum number of adults allowed in one room of this roomtype.
minAdultOccupancy	Integer	Yes	The minimum number of adults allowed in the room.
maxChildOccupancy	Integer	Yes	The maximum number of children allowed in the room.
minChildOccupancy	Integer	Yes	The minimum number of children allowed in the room.
totalMaxOccupancy	Integer	Yes	The total number of occupants allowed in the room.
maxOccupancyForDefaultPrice	Integer	Yes	The minimum number of adults in the room, above which, additional pricing kicks in.
bedtypes	Array	No	An array of bedtype objects.
amenities	Array	No	An array of amenity objects.
images	Array	No	An array of image objects.

Currency

CancellationPolicies

Error

Copyright © 2025 Hotel Trader, LLC. All rights reserved.