Hotel Release Notes
This topic lists the Travelport JSON Hotel APIs releases for 2025. See Archived Release Notes for releases from previous years.
Create, Add, and Modify Passive Segments
New APIs for passive segments | 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.
Hotel Availability
Availability 25.11.22: Response enhancements | 17 Apr 2025
Enhancements to the Availability response payload.
Show Code Changes Summary
The following model changes were made with this update.
Availability request
-
None
Availability response
-
Price Breakdown: Taxes
-
To demarcate which taxes are part of the base, part of the total price, or paid at the property
-
includedInBase: Indicates whether tax is included in Amount/Base value. Possible values are Yes, No, Unknown.
-
excludedFromTotalPriceInd: Boolean. Default is false. When set to true, tax is not included in TotalPrice and will be paid at property.
Code snippet
"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
-
To demarcate which fees are part of the base, part of the total price, or paid at the property
-
TotalFees: Total fees included in the total price.
-
TotalAdditionalFeesPaidLocally: Fees due separately at the property. Expect them to be paid in local currency.
-
includedInBaseInd: Boolean. Default is false. Fee is included in Base Price.
-
includedInTotalPriceInd: Boolean. Default is false. Fee is included in Total Price.
-
Code snippet
"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
}
}
}
]
},
-
Traveler Identification
-
To notify the user/traveler of identification needs associated to a particular room rate
-
CustomerLoyaltyIDRequiredAtReservation: Boolean. Default is false. The rate returned is contingent on a membership number to be included within the sell request, typically associated to frequent guest or frequent flyer loyalty numbers.
-
RateQualificationIDRequiredAtCheckIn: Boolean. Default is false. 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.
-
Code snippet
"TermsAndConditions": {
"@type": "TermsAndConditionsHospitality",
"Guarantee": [
{
"@type": "Guarantee",
"code": "CCG",
"guaranteeType": "GuaranteeRequired"
}
],
"CancelPenalty": [
{
"@type": "CancelPenalty",
"Description": "Cancellations are free if made before Sep 03, 2025, 23:59 local hotel time.",
"Deadline": {
"@type": "Deadline",
"SpecificDate": {
"start": "2025-03-11",
"end": "2025-09-03"
},
"Time": "23:59:00"
},
"HotelPenalty": {
"@type": "HotelPenaltyPercent",
"appliesTo": "Amount",
"Percent": 0
},
"Refundable": "Yes"
},
{
"@type": "CancelPenalty",
"Description": "After this time, starting Sep 03, 2025, 00:00 local hotel time, a fee of 100% of the total stay will be charged for cancellations made early.",
"Deadline": {
"@type": "Deadline",
"SpecificDate": {
"start": "2025-09-03"
}
},
"HotelPenalty": {
"@type": "HotelPenaltyPercent",
"appliesTo": "Amount",
"Percent": 100
},
"Refundable": "No"
}
],
"Description": [
"Hotel Loyalty Discount Honors Restricted Cxl",
"1 King Bed",
"Free Internet / Serenity Bed-Luxury Linens",
"HDTV / Work Desk / Coffee / MP3 Clock"
],
"ProductRateCodeInfo": [
{
"@type": "ProductRateCodeInfo",
"RateCodeInfo": {
"value": "HL1",
"rateName": "HOTEL LOYALTY DISCOUNT",
"rateID": "L1L1000",
"rateCategory": "MultLevel/Negotiated/Secure"
}
}
],
"RatePaymentInfo": "PostPay",
"CustomerLoyaltyIDRequiredAtReservation": true
}
"TermsAndConditions": {
"@type": "TermsAndConditionsHospitality",
"Guarantee": [
{
"@type": "Guarantee",
"code": "CCG",
"guaranteeType": "GuaranteeRequired"
}
],
"CancelPenalty": [
{
"@type": "CancelPenalty",
"Description": "Cancellations are free if made before Sep 07, 2025, 23:59 local hotel time.",
"Deadline": {
"@type": "Deadline",
"SpecificDate": {
"start": "2025-03-11",
"end": "2025-09-07"
},
"Time": "23:59:00"
},
"HotelPenalty": {
"@type": "HotelPenaltyPercent",
"appliesTo": "Amount",
"Percent": 0
},
"Refundable": "Yes"
},
{
"@type": "CancelPenalty",
"Description": "After this time, starting Sep 07, 2025, 00:00 local hotel time, a fee of 100% of the total stay will be charged for cancellations made early.",
"Deadline": {
"@type": "Deadline",
"SpecificDate": {
"start": "2025-09-07"
}
},
"HotelPenalty": {
"@type": "HotelPenaltyPercent",
"appliesTo": "Amount",
"Percent": 100
},
"Refundable": "No"
}
],
"Description": [
"Military Family Rate",
"Exclusive For Active Duty/Veterans/Retired",
"Military. Us Or Canada Military ID Required",
"1 King Bed",
"Free Internet / Serenity Bed-Luxury Linens",
"HDTV / Work Desk / Coffee / MP3 Clock"
],
"ProductRateCodeInfo": [
{
"@type": "ProductRateCodeInfo",
"RateCodeInfo": {
"rateCategory": "Government"
}
}
],
"RatePaymentInfo": "PostPay",
"RateQualificationIDRequiredAtCheckIn": true
}
Hotel Rules
Rules 25.11.22: Response enhancements | 17 Apr 2025
Enhancements to the Rules response payload for Price Breakdown taxes and fees, and Traveler Identification.
Show Code Changes Summary
The following model changes were made with this update.
Rules request
- None
Rules response
-
Price Breakdown: Taxes
-
To demarcate which taxes are part of the base, part of the total price, or paid at the property
-
includedInBase: Indicates whether tax is included in Amount/Base value. Possible values are Yes, No, Unknown.
-
excludedFromTotalPriceInd: Boolean. Default is false. When set to true, tax is not included in TotalPrice and will be paid at property.
-
Code snippet
"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
-
To demarcate which fees are part of the base, part of the total price, or paid at the property
-
TotalFees: Total fees included in the total price.
-
TotalAdditionalFeesPaidLocally: Fees due separately at the property. Expect them to be paid in local currency.
-
includedInBaseInd: Boolean. Default is false. Fee is included in Base Price.
-
includedInTotalPriceInd: Boolean. Default is false. Fee is included in Total Price.
-
Code snippet
"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
}
}
}
]
},-
Traveler Identification
-
To notify the user/traveler of identification needs associated to a particular room rate
-
CustomerLoyaltyIDRequiredAtReservation: Boolean. Default is false. The rate returned is contingent on a membership number to be included within the sell request, typically associated to frequent guest or frequent flyer loyalty numbers.
-
RateQualificationIDRequiredAtCheckIn: Boolean. Default is false. 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.
-
Code snippet
"TermsAndConditionsFull": {
"@type": "TermsAndConditionsFullHospitality",
"Guarantee": [
{
"@type": "Guarantee",
"code": "CCG",
"guaranteeType": "GuaranteeRequired"
}
],
"CancelPenalty": [
{
"@type": "CancelPenalty",
"Description": "Cancellations are free if made before Sep 03, 2025, 23:59 local hotel time.",
"Deadline": {
"@type": "Deadline",
"SpecificDate": {
"start": "2025-03-11",
"end": "2025-09-03"
},
"Time": "23:59:00"
},
"HotelPenalty": {
"@type": "HotelPenaltyPercent",
"appliesTo": "Amount",
"Percent": 0
},
"Refundable": "Yes"
},
{
"@type": "CancelPenalty",
"Description": "After this time, starting Sep 03, 2025, 00:00 local hotel time, a fee of 100% of the total stay will be charged for cancellations made early.",
"Deadline": {
"@type": "Deadline",
"SpecificDate": {
"start": "2025-09-03"
}
},
"HotelPenalty": {
"@type": "HotelPenaltyPercent",
"appliesTo": "Amount",
"Percent": 100
},
"Refundable": "No"
}
],
"Description": [
"Hotel Loyalty Discount Honors Restricted Cxl",
"1 King Bed",
"Free Internet / Serenity Bed-Luxury Linens",
"HDTV / Work Desk / Coffee / MP3 Clock"
],
"ProductRateCodeInfo": [
{
"@type": "ProductRateCodeInfo",
"RateCodeInfo": {
"value": "HL1",
"rateName": "HOTEL LOYALTY DISCOUNT",
"rateID": "L1L1000",
"rateCategory": "MultLevel/Negotiated/Secure"
}
}
],
"RatePaymentInfo": "PostPay",
"CustomerLoyaltyIDRequiredAtReservation": true
}
"TermsAndConditionsFull": {
"@type": "TermsAndConditionsFullHospitality",
"Guarantee": [
{
"@type": "Guarantee",
"code": "CCG",
"guaranteeType": "GuaranteeRequired"
}
],
"CancelPenalty": [
{
"@type": "CancelPenalty",
"Description": "Cancellations are free if made before Sep 07, 2025, 23:59 local hotel time.",
"Deadline": {
"@type": "Deadline",
"SpecificDate": {
"start": "2025-03-11",
"end": "2025-09-07"
},
"Time": "23:59:00"
},
"HotelPenalty": {
"@type": "HotelPenaltyPercent",
"appliesTo": "Amount",
"Percent": 0
},
"Refundable": "Yes"
},
{
"@type": "CancelPenalty",
"Description": "After this time, starting Sep 07, 2025, 00:00 local hotel time, a fee of 100% of the total stay will be charged for cancellations made early.",
"Deadline": {
"@type": "Deadline",
"SpecificDate": {
"start": "2025-09-07"
}
},
"HotelPenalty": {
"@type": "HotelPenaltyPercent",
"appliesTo": "Amount",
"Percent": 100
},
"Refundable": "No"
}
],
"Description": [
"Military Family Rate",
"Exclusive For Active Duty/Veterans/Retired",
"Military. Us Or Canada Military ID Required",
"1 King Bed",
"Free Internet / Serenity Bed-Luxury Linens",
"HDTV / Work Desk / Coffee / MP3 Clock"
],
"ProductRateCodeInfo": [
{
"@type": "ProductRateCodeInfo",
"RateCodeInfo": {
"rateCategory": "Government"
}
}
],
"RatePaymentInfo": "PostPay",
"RateQualificationIDRequiredAtCheckIn": true
}
Hotel Create Reservation
Creat Reservation 25.11.22: Response enhancements | 17 Apr 2025
Enhancements to the Create Reservation response payload.
Show Code Changes Summary
The following model changes were made with this update.
Create request
- None
Create response
-
Price Breakdown: Taxes
-
To demarcate which taxes are part of the base, part of the total price, or paid at the property
-
includedInBase: Indicates whether tax is included in Amount/Base value. Possible values are Yes, No, Unknown.
-
excludedFromTotalPriceInd: Boolean. Default is false. When set to true, tax is not included in TotalPrice and will be paid at property.
-
Code snippet
"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
-
To demarcate which fees are part of the base, part of the total price, or paid at the property
-
TotalFees: Total fees included in the total price.
-
TotalAdditionalFeesPaidLocally: Fees due separately at the property. Expect them to be paid in local currency.
-
includedInBaseInd: Boolean. Default is false. Fee is included in Base Price.
-
includedInTotalPriceInd: Boolean. Default is false. Fee is included in Total Price.
-
Code snippet
"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
}
}
}
]
},-
Traveler Identification
-
To notify the user/traveler of identification needs associated to a particular room rate
-
CustomerLoyaltyIDRequiredAtReservation: Boolean. Default is false. The rate returned is contingent on a membership number to be included within the sell request, typically associated to frequent guest or frequent flyer loyalty numbers.
-
RateQualificationIDRequiredAtCheckIn: Boolean. Default is false. 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.
-
Code snippet
"TermsAndConditionsFull": {
"@type": "TermsAndConditionsFullHospitality",
"Guarantee": [
{
"@type": "Guarantee",
"code": "CCG",
"guaranteeType": "GuaranteeRequired"
}
],
"CancelPenalty": [
{
"@type": "CancelPenalty",
"Description": "Cancellations are free if made before Sep 03, 2025, 23:59 local hotel time.",
"Deadline": {
"@type": "Deadline",
"SpecificDate": {
"start": "2025-03-11",
"end": "2025-09-03"
},
"Time": "23:59:00"
},
"HotelPenalty": {
"@type": "HotelPenaltyPercent",
"appliesTo": "Amount",
"Percent": 0
},
"Refundable": "Yes"
},
{
"@type": "CancelPenalty",
"Description": "After this time, starting Sep 03, 2025, 00:00 local hotel time, a fee of 100% of the total stay will be charged for cancellations made early.",
"Deadline": {
"@type": "Deadline",
"SpecificDate": {
"start": "2025-09-03"
}
},
"HotelPenalty": {
"@type": "HotelPenaltyPercent",
"appliesTo": "Amount",
"Percent": 100
},
"Refundable": "No"
}
],
"Description": [
"Hotel Loyalty Discount Honors Restricted Cxl",
"1 King Bed",
"Free Internet / Serenity Bed-Luxury Linens",
"HDTV / Work Desk / Coffee / MP3 Clock"
],
"ProductRateCodeInfo": [
{
"@type": "ProductRateCodeInfo",
"RateCodeInfo": {
"value": "HL1",
"rateName": "HOTEL LOYALTY DISCOUNT",
"rateID": "L1L1000",
"rateCategory": "MultLevel/Negotiated/Secure"
}
}
],
"RatePaymentInfo": "PostPay",
"CustomerLoyaltyIDRequiredAtReservation": true
}
"TermsAndConditionsFull": {
"@type": "TermsAndConditionsFullHospitality",
"Guarantee": [
{
"@type": "Guarantee",
"code": "CCG",
"guaranteeType": "GuaranteeRequired"
}
],
"CancelPenalty": [
{
"@type": "CancelPenalty",
"Description": "Cancellations are free if made before Sep 07, 2025, 23:59 local hotel time.",
"Deadline": {
"@type": "Deadline",
"SpecificDate": {
"start": "2025-03-11",
"end": "2025-09-07"
},
"Time": "23:59:00"
},
"HotelPenalty": {
"@type": "HotelPenaltyPercent",
"appliesTo": "Amount",
"Percent": 0
},
"Refundable": "Yes"
},
{
"@type": "CancelPenalty",
"Description": "After this time, starting Sep 07, 2025, 00:00 local hotel time, a fee of 100% of the total stay will be charged for cancellations made early.",
"Deadline": {
"@type": "Deadline",
"SpecificDate": {
"start": "2025-09-07"
}
},
"HotelPenalty": {
"@type": "HotelPenaltyPercent",
"appliesTo": "Amount",
"Percent": 100
},
"Refundable": "No"
}
],
"Description": [
"Military Family Rate",
"Exclusive For Active Duty/Veterans/Retired",
"Military. Us Or Canada Military ID Required",
"1 King Bed",
"Free Internet / Serenity Bed-Luxury Linens",
"HDTV / Work Desk / Coffee / MP3 Clock"
],
"ProductRateCodeInfo": [
{
"@type": "ProductRateCodeInfo",
"RateCodeInfo": {
"rateCategory": "Government"
}
}
],
"RatePaymentInfo": "PostPay",
"RateQualificationIDRequiredAtCheckIn": true
}