Hotel Search Modifiers
Additional modifiers can be added to a Hotel Search request to narrow the search results. See also Hotel Search Location Modifiers for search options specific to a hotel property location.
If Hotel Search modifiers are used, they are prioritized based on a default order, unless an alternate search priority is specified.
Important: HotelSearchModifiers must be sent in the sequence in which they are listed in the schema or else an out of sequence error is returned. For example, PermittedChains must be sent before HotelRating modifiers.
/HotelSearchModifiers |
Description |
---|---|
@NumberOfAdults |
The number of adult travelers in the booking in the NumberOfAdults attribute. If no number is input, the default number of travelers is one Adult. |
@NumberOfRooms |
Requests hotel availability based on the number of rooms required for the itinerary. |
@MaxProperties |
The maximum number of properties returned in a Hotel Search response. |
@IsRelaxed |
If "false", the response includes only properties that meet the specific search modifiers in the request. If "true", the response may be relaxed to include other properties that do not meet all of the requested search modifiers. |
@PreferredCurrency |
Indicates a preferred currency in the Search request. This applies to all providers that support Hotel segments; however, the response attributes returned vary by carrier. |
@AvailableHotelsOnly |
Search only for available hotels. |
@NumOfRatePlans |
Specifies the number of rate plans (if available) to be returned for the requested property.
This attribute is currently supported only for Hotel Super Shopper.
|
@ReturnAmenities |
Indicates if amenities for a hotel property, such as pool, restaurant, and high-speed internet, are returned for all properties in Hotel Search responses. Galileo, Apollo, and Worldspan only. |
/Permitted Hotel Chain /Prohibited Hotel Chain |
Permits (includes) or prohibits (excludes) properties owned by specified hotel chains in the response. |
/PermittedProviders |
Limits the request to responses only from the specified providers. If providers are not specified, responses from all providers provisioned for the Target Branch (Work Area Branch) may be returned. |
/LoyaltyCard |
Includes the traveler's Loyalty Program (Frequent Guest) for a specific hotel chain. |
/HotelName |
Request a hotel property using all or part of the property name. |
/CorporateDiscountID |
Includes a Corporate Discounts and/or Negotiated Rates between an organization and a vendor. Corporate Discount IDs and Negotiated Rate codes can be created for corporations or other organizations that offered discounts with preferred suppliers. The ID/code identifies discounts, properties, and rates that apply to a specific organization. |
/RateCategory |
Searches hotels by rate categories, which define the general room rate, such as standard, corporate, government, and weekend rates. |
/HotelRating |
Searches by a hotel property rating or range of ratings. |
/SearchPriority |
Hotel properties are returned in a random sequence, unless modifiers are added to the request. If Hotel Search modifiers are used, they are prioritized based on a default order, unless SearchPriority is used to specify an alternate priority order. |
/HotelBedding |
Search by bed type for an initial hotel search (Worldspan only). Not supported for Galileo and Apollo in an initial property search. |
/Amenities | Request specific amenities, such as pool, restaurant, and high-speed internet, for a hotel property. |
/NumberOfChildren |
Indicate the number of child travelers in the booking. |
/HotelTransportation |
Request a specific Transportation Type in the Hotel Search request. Hotels that support the requested Transportation Type are returned in the response. |
Prioritizing Search Modifiers
Hotel properties are returned in a random sequence, unless modifiers are added to the request. Universal API supports prioritization for the following modifiers (in default order of priority):
- Corporate Discounts and Negotiated Rates
- Hotel Chain
- Property Name
- Distance and Direction
- Rate Category
- Rating
- Transportation
HotelModifiers/SearchPriority/Criteria can be used to modify the default prioritization. The Order attribute indicates the priority, while the Type attribute indicates the specific modifier.
Priority processing can be applied when multiple modifiers are included in a request, depending on the supplier. In cases where multiple values are allowed for same search modifier (e.g., chain codes), the priority is in ascending order: If HY and HI are sent as chain codes, HY is priority 2 and HI is priority 3.
An error is returned if duplicate priority/order is sent in the request.