Hotel Release Notes
This topic lists the Travelport JSON Hotel APIs releases for 2025. See Archived Release Notes for releases from previous years.
- Passive segments support
- Associated airport and city codes in reservation responses
- Return GIATA and Booking.com ratings in Hotel Search and Details
- Return AAA and NTM ratings in Hotel Search and Details
- PriceBreakdown and TermsAndConditions updates
Passive segments support | 1 Jul 2025
Adds the following new APIs to support creating and managing passive segments:
-
Create Passive Reservation: Create a new hotel reservation that includes only a passive hotel segment.
-
Add Passive Reservation: Add a passive segment to an existing booking.
-
Modify Passive Reservation: Update details on a passive segment.
A passive hotel segment is any segment that was made using anything other than the JSON APIs. Passive segments are informational only. They do not result in a reservation or a change in inventory. Information on a passive segment is not received from or passed to the hotel supplier. Instead, passive segments provide a way to consolidate all booking information, including details from direct hotel bookings or even phone reservations.
Passive segments can also be placeholders, used to hold dates or to create a retention segment, which keeps a booking active in the system.
Associated airport and city codes in reservation responses | 5 Jun 2025
In the response for Create Reservation, Reservation Retrieve, and other APIs that return reservations, adds to the Product object the following new objects:
-
associatedCityCode: IATA code for the city closest to the property in this offer.
-
associatedAirportCode: IATA code for the airport closest to the property in this offer.
{
"ReservationResponse": {
"Reservation": {
"@type": "ReservationDetail",
"Offer": [
{
"@type": "Offer",
"id": "O1",
"Identifier": {
"value": "f8a64195-ef27-4af2-9380-fd6f6e21f2d6",
"authority": "TVPT"
},
"Product": [
{
"@type": "ProductHospitality",
"Quantity": 4,
"bookingCode": "BBB333",
"passiveBookingReasonCode": "G",
"guests": 9,
"propertyName": "Biscuit hotel",
"associatedCityCode": "AUS",
"associatedAirportCode": "MMR",...
Return GIATA and Booking.com ratings in Hotel Search and Details | 26 Jun 2025
Adds support for returning hotel ratings from GIATA and Booking.com (for Booking.com content) to the Search by Location or ID and Details responses, when available. Ratings content from GIATA, NorthStar, AAA, and/or Booking.com may be returned for any property depending on availability and content source.
The following information is provided by GIATA about its hotel ratings:
GIATA is a Berlin-based travel technology company specializing in hotel content management, mapping, and distribution solutions for the tourism industry. At GIATA, Hotels are evaluated based on 239+ criteria across several categories:
-
Reception & Services: 24/7 front desk, multilingual staff, luggage service
-
Rooms: Size, furnishings, amenities like Wi-Fi, minibar, air conditioning
-
Food & Beverage: On-site restaurant, breakfast options, room service
-
Leisure & Events: Gym, spa, conference rooms
-
Cleanliness & Quality: Maintenance, hygiene, guest comfort
-
Online Presence: Website quality, booking options, digital services
Each star level has minimum requirements, and hotels can earn a “Superior” label if they exceed expectations for that category.
What Do the Stars Mean?
-
1 Star: Basic accommodation, clean rooms, limited services
-
2 Stars: Private bathrooms, better furnishings, breakfast service
-
3 Stars: 24/7 reception, restaurant, air conditioning
-
4 Stars: Concierge, gym/spa, multilingual staff, minibar
-
5 Stars: Luxury experience - gourmet dining, spacious rooms, personalized service, 24-hour room service
The following information is provided by Booking.com about its hotel ratings:
Booking.com 's traditional hotel star ratings (1 to 5 stars) is based on information provided by the hotel or certified by local tourism authorities. These ratings reflect the level of service, amenities, and comfort a guest can expect.
-
1 Star: Basic accommodation with minimal services.
-
2 Stars: Modest comfort, often with private bathrooms and basic amenities.
-
3 Stars: Mid-range hotels with reception services, dining options, and more room features.
-
4 Stars: High-quality service, larger rooms, and additional facilities like gyms or concierge.
-
5 Stars: Luxury experience with premium services, spacious rooms, and top-tier amenities.
Important Notes:
-
These ratings are not assigned by Booking.com.
-
They may vary slightly by country depending on local standards.
-
They help travelers quickly compare hotels based on expected quality.
Return AAA and NTM ratings in Hotel Search and Details | 17 Apr 2025
Adds support for returning hotel ratings from NorthStar and AAA (American Automobile Association) to the Search by Location/ID and Details responses. Returned in the Ratings object when available. Ratings content from either or both NorthStar and AAA may be returned for any property depending on availability.
The following information is provided by NorthStar about its hotel ratings:
NorthStar uses a 10-level system ranging from basic budget accommodations to ultra-luxury
-
Moderate Tourist Class – Basic, no-frills budget accommodations.
-
Tourist Class – Budget-friendly with minimal services; may be near highways or airports.
-
Superior Tourist Class – Mid-market economy hotels with functional amenities.
-
Moderate First Class – Comfortable, simple accommodations with modern essentials.
-
Limited Service First Class – Quality accommodations with limited public areas and dining.
-
First Class – Full-service hotel with amenities suitable for all travelers.
-
Superior First Class – Upscale with stylish design and broad services.
-
Moderate Deluxe – High-end, often business-focused hotels.
-
Deluxe – Exceptional luxury with upscale amenities and service.
-
Superior Deluxe – Top-tier, exclusive luxury hotels with personalized service.
The following information is provided by AAA about its hotel ratings:
AAA uses a 5-Diamond scale to indicate the level of service, amenities, and overall experience:
1 Diamond – Budget-oriented; basic accommodations with minimal services.
2 Diamonds – Affordable and casual; familiar settings with modest comfort.
3 Diamonds – Enhanced experience; comfortable and well-appointed.
4 Diamonds – Refined and upscale; notable for service and amenities.
5 Diamonds – Ultimate luxury; exceptional service, design, and experience.
"Rating": [
{
"value": 4,
"provider": "NTM"
},
{
"value": 4,
"provider": "AAA"
}
],
PriceBreakdown and TermsAndConditions updates | 17 Apr 2025
Updates the PriceBreakdown/Taxes and Fees objects and the TermsAndConditions objects as follows. These objects are returned in the Rules, Availability, and Create Reservation response payloads.
PriceBreakdown/Taxes/Tax: Adds the following two indicators:
-
includedInBase: Indicates whether tax is included in Amount/Base value. Possible values are Yes, No, Unknown.
-
excludedFromTotalPriceInd: Boolean. When returned as true, this tax is not included in TotalPrice and will be paid at property. Default is false.
"Taxes": {
"@type": "TaxesDetail",
"TotalTaxes": 38.36,
"Tax": [
{
"value": 38.36,
"currencyCode": "USD",
"taxCode": "25",
"purpose": "Standard",
"description": "Standard",
"includedInBase": "No","excludedFromTotalPriceInd": false
}
]
},
Price Breakdown/Fees object: Adds the following objects and Boolean indicators to note which fees are part of the base amount, part of the total price, or to be paid at the property:
-
TotalFees: Amount of fees included in the total price.
-
TotalAdditionalFeesPaidLocally: Amount of fees due separately at the property, to be paid in local currency.
-
includedInBaseInd: Boolean: true indicates fee is included in BasePrice. Default is false.
-
includedInTotalPriceInd: Boolean: true indicates fee is included in TotalPrice. Default is false.
"Fees": {
"type": "FeesDetail",
"TotalFees": 0.00,"TotalAdditionalFeesPaidLocally": 45.00,
"Fee": [
{
"type": "Fee",
"feeCode": "12",
"purpose": "Resort fee",
"description": "Resort fee",
"feeApplication": "PerAccommodation",
"feeFrequency": "PerStay",
"includedInBaseInd": false,"includedInTotalPriceInd": false,
"FeeAmountOrPercent": {
"type": "FeeAmountOrPercentAmount",
"Amount": {
"code": "USD",
"value": 45
}
}
}
]
},
In the TermsAndConditions object (primary objects truncated for brevity in the example below), adds the following Boolean indicators:
-
CustomerLoyaltyIDRequiredAtReservation: Boolean: true indicates the rate returned requires a membership number in the sell request, typically associated to frequent guest or frequent flyer loyalty numbers. Default is false.
-
RateQualificationIDRequiredAtCheckIn: Boolean: true indicates the discounted rate returned may be denied at the property if guest does not show proof of qualifying, typically a government/military/workplace/association/membership ID. Default is false.
"TermsAndConditions": {
"@type": "TermsAndConditionsHospitality",
"Guarantee": [...],
"CancelPenalty": [...],
"Description": [...],
"ProductRateCodeInfo": [...],
"RatePaymentInfo": "PostPay",
"CustomerLoyaltyIDRequiredAtReservation": true
}
"TermsAndConditions": {
"@type": "TermsAndConditionsHospitality",
"Guarantee": [...],
"CancelPenalty": [...],
"Description": [...],
"ProductRateCodeInfo": [...],
"RatePaymentInfo": "PostPay",
"RateQualificationIDRequiredAtCheckIn": true
}