Travelport Universal API supports Hotel Search requests that limit the response only to hotel properties that specifically indicate availability. The functionality varies by provider, but if AvailableHotelsOnly is not set, the normal hotel availability response is returned, including hotels that may not provide hotel inventory status or provide status as Closed, Other, or On Request.
Request
An AvailableHotelsOnly attribute is part of the Hotel Search request (HotelSearchAvailabilityReq/HotelSearchModifiers). The attribute can be set to "true", "false", or the default blank, which is processed as "false".
Response
The response returns standard Hotel Search data with only available hotels as flagged by the provider. The hotel supplier is responsible for the availability status for each property via the provider.
If AvailableHotelsOnly is set to "false" or blank, the default provider functionality is returned in HotelSearchAvailabilityRsp:
- Galileo and Apollo return only available hotel properties for the requested search parameters.
- Worldspan return all hotel properties for the requested search parameters, regardless of availability.
If AvailableHotelsOnly is set to "true", providers return only hotels that have an Available status. See Exceptions for details by provider.
Exceptions
Galileo(1G) and Apollo (1V)
When AvailableHotelsOnly="true":
- The response includes only available hotels from the provider.
- If no hotels are available, an error is returned: No hotels are available for search criteria.
Worldspan (1P)
When AvailableHotelsOnly="true":
- If no hotels are available, unknown (blank availability) properties are returned in the response, and a warning is returned: No available hotel properties as requested, unknown availability hotels have been responded.
- If no available hotels or unknown hotels are returned, an error is returned: No hotels are available for search criteria.
