This operation allows you to modify a previously confirmed reservation.
The following types of modifications are permitted:
- Add a new room to an existing booking
- Modify a room in an existing booking
- Critical modifications - This includes changes in rateplan / roomtype / date changes that may lead to pricing changes
- Non-critical modifications - This includes changes like adding a comment or changing a guest name that does not involve any change in pricing
- Cancel a room in an existing booking without affecting other active rooms in the reservation
See the DOCS tab on the Reservation GraphQL Docs for detailed information about the type definitions.
For Critical Modifications, we currently do a cancel/rebook. For example, if a date change modification request is sent for a room, the response object will contain 2 room nodes - one for the original canceled room, and the second for the rebooking of the new room on different dates.
Schema
mutation modify($Modify: ModifyRequestInput) {
modify(modifyRequest: $Modify) {
htConfirmationCode
clientConfirmationCode
otaConfirmationCode
consolidatedComments
consolidatedHTMLComments
bookingDate
specialRequests
propertyDetails {
...propertyDetails
}
aggregateGrossPrice
aggregateNetPrice
aggregateTax
aggregatePayAtProperty
rooms {
...roomDetails
}
}
}
fragment addressDetails on Address {
address1
address2
cityName
countryCode
stateName
zipCode
}
fragment propertyDetails on PropertyResponseEntity {
address {
...addressDetails
}
checkInTime
checkOutTime
city
hotelImageUrl
latitude
longitude
propertyId
propertyName
starRating
shortDescription
longDescription
timeZone
checkInPolicy
}
fragment roomDetails on RoomResponse {
cancellationDate
cancellationFee
cancelled
cancellationPolicies {
...cancelPolicyDetails
}
checkInDate
checkOutDate
clientRoomConfirmationCode
htRoomConfirmationCode
crsConfirmationCode
crsCancelConfirmationCode
pmsConfirmationCode
refundable
roomName
mealplanOptions {
...mealPlanOptions
}
rates {
...ratesDetails
}
occupancy {
guestAges
}
guests {
...guestDetails
}
roomSpecialRequests
}
fragment mealPlanOptions on MealplanOptions {
mealplanDescription
mealplanCode
mealplanName
}
fragment cancelPolicyDetails on HtCancellationPolicy {
startWindowTime
endWindowTime
currency
cancellationCharge
timeZone
timeZoneUTC
type
}
fragment noShowPolicies on HtCancellationPolicy {
startWindowTime
currency
noShowCharge
timeZone
timeZoneUTC
type
}
fragment ratesDetails on RoomRatesResponseEntity {
currency
netPrice
tax
grossPrice
dailyPrice
dailyTax
payAtProperty
aggregateTaxInfo {
payAtBooking {
description
name
currency
value
}
payAtProperty {
description
name
currency
value
}
}
}
fragment guestDetails on RoomGuestResponseEntity {
adult
age
email
firstName
lastName
phone
primary
}
Samples
Based on the type of modification requested, certain parameters are mandatory while others are not. See the examples below to understand how to send a modification request.
In all cases, clientRoomConfirmationCode, htRoomConfirmationCode, and status are mandatory at rooms room-level node.
All-in-one Modifications
Request
{
"Modify": {
"htConfirmationCode": "HT-VFBLEY",
"clientConfirmationCode": "tc-test-1406",
"otaConfirmationCode": "test-client-3286",
"otaClientName": "test-htrader-graphql",
"specialRequests": [
"reservation test comment"
],
"rooms": [
{
"htRoomConfirmationCode": "HT-VFBLEY-1",
"clientRoomConfirmationCode": "tc-test-1406-1",
"roomSpecialRequests": [
"cancelling room to book a new one again"
],
"status": "CANCEL"
},
{
"htRoomConfirmationCode": "HT-VFBLEY-2",
"clientRoomConfirmationCode": "tc-test-1406-2",
"roomSpecialRequests": [
"changing guest name"
],
"guests": [
{
"firstName": "test",
"lastName": "new name change",
"email": "test@hoteltrader.com",
"adult": true,
"age": 24,
"phone": "1234567890",
"primary": true
}
],
"status": "MODIFY"
},
{
"htIdentifier": "11019171|1117101511101|111416142|121012141-10111-10151|121012141-10111-10181|1e1d1312141d11131-141a16141-141718121-1b1f12141-1e1128151912171118131f1|1116181617111716151215271",
"clientRoomConfirmationCode": "tc-test-1406-3",
"roomSpecialRequests": [
"adding 3rd room to booking"
],
"rates": {
"netPrice": 690,
"tax": 41.49,
"grossPrice": 731.49,
"payAtProperty": 90,
"dailyPrice": [
230,
230,
230
],
"dailyTax": [
13.83,
13.83,
13.83
]
},
"occupancy": {
"guestAges": "30,5"
},
"guests": [
{
"firstName": "test",
"lastName": "booking",
"email": "test@hoteltrader.com",
"adult": true,
"age": 24,
"phone": "1234567890",
"primary": true
}
],
"status": "BOOK"
}
]
}
}
Response
{
"data": {
"modify": {
"htConfirmationCode": "HT-VFBLEY",
"clientConfirmationCode": "tc-test-1406",
"otaConfirmationCode": "test-client-3286",
"consolidatedComments": "Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.. Reservation is refundable but nonModifiable. Minimum adult age at check in is 21 years. Room#1: Free Breakfast. Room#2: Free Breakfast. Room#3: Free Breakfast. Room#2: A Resort Fee totaling $90.00 will be charged for the stay. Resort Fee of $30 plus tax per room per night which covers: free local, long distance and international phone calls. Choice of complimentary wine or water, or both upon check-in. Complimentary coffee & tea in our lobby each morning. Access to WiFi 24/7 for all devices. Around the clock access to our fitness center with treadmills, bikes, and weights. Storage of your luggage and your packages delivered to the hotel while you explore the city.. Room#3: A Resort Fee totaling $90.00 will be charged for the stay. Resort Fee of $30 plus tax per room per night which covers: free local, long distance and international phone calls. Choice of complimentary wine or water, or both upon check-in. Complimentary coffee & tea in our lobby each morning. Access to WiFi 24/7 for all devices. Around the clock access to our fitness center with treadmills, bikes, and weights. Storage of your luggage and your packages delivered to the hotel while you explore the city.. ",
"consolidatedHTMLComments": "<ul><li>Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.. </li><li>Reservation is refundable but nonModifiable. </li><li>Minimum adult age at check in is 21 years. </li><li> Room#1: Free Breakfast. Room#2: Free Breakfast. Room#3: Free Breakfast. </li><li> Room#2: A Resort Fee totaling $90.00 will be charged for the stay. Resort Fee of $30 plus tax per room per night which covers: free local, long distance and international phone calls. Choice of complimentary wine or water, or both upon check-in. Complimentary coffee & tea in our lobby each morning. Access to WiFi 24/7 for all devices. Around the clock access to our fitness center with treadmills, bikes, and weights. Storage of your luggage and your packages delivered to the hotel while you explore the city.. Room#3: A Resort Fee totaling $90.00 will be charged for the stay. Resort Fee of $30 plus tax per room per night which covers: free local, long distance and international phone calls. Choice of complimentary wine or water, or both upon check-in. Complimentary coffee & tea in our lobby each morning. Access to WiFi 24/7 for all devices. Around the clock access to our fitness center with treadmills, bikes, and weights. Storage of your luggage and your packages delivered to the hotel while you explore the city.. </li></ul>",
"bookingDate": "2024-06-14T04:40:00.000-0400",
"specialRequests": [
"reservation test comment"
],
"propertyDetails": {
"address": {
"address1": "3820 North Roosevelt Blvd",
"address2": "",
"cityName": "Key West",
"countryCode": "US",
"stateName": "Florida",
"zipCode": "33040"
},
"checkInTime": "4:00 PM",
"checkOutTime": "12:00 PM",
"city": "Key West",
"hotelImageUrl": null,
"latitude": "24.571342",
"longitude": "-81.75515999999999",
"propertyId": 553402,
"propertyName": "24 North Hotel Key West",
"starRating": 3.5,
"shortDescription": "24 North Hotel is Key West's answer to a casual-resort luxury",
"longDescription": "24 North Hotel offers guests a genuine island getaway experience. With 145 guest rooms, views of the ocean, and a lively pool scene, guests can embrace the Key West culture. ",
"timeZone": "America/New_York",
"checkInPolicy": "Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest."
},
"aggregateGrossPrice": 2194.47,
"aggregateNetPrice": 2070,
"aggregateTax": 124.47,
"aggregatePayAtProperty": 180,
"rooms": [
{
"cancellationDate": "2024-06-14T04:44:16.000-0400",
"cancellationFee": 0,
"cancelled": true,
"cancellationPolicies": [
{
"startWindowTime": "2025-01-04 16:00:00",
"endWindowTime": "2025-01-05 16:00:00",
"currency": "USD",
"cancellationCharge": 731.49,
"timeZone": "America/New_York", "timeZoneUTC" : "-05:00"
}
],
"checkInDate": "2025-01-05",
"checkOutDate": "2025-01-08",
"clientRoomConfirmationCode": "tc-test-1406-1",
"htRoomConfirmationCode": "HT-VFBLEY-1",
"crsConfirmationCode": "KEY24N107415359",
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": null,
"refundable": true,
"roomName": "Standard | Double Queen-S2Q",
"mealplanOptions": {
"mealplanDescription": "Free Breakfast",
"mealplanCode": "BBF",
"mealplanName": "Free Breakfast"
},
"rates": {
"currency": "USD",
"netPrice": 690,
"tax": 41.49,
"grossPrice": 731.49,
"dailyPrice": [
0,
0,
0
],
"dailyTax": [
0,
0,
0
],
"payAtProperty": 0,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": "State Tax",
"name": "State Tax",
"currency": "USD",
"value": 0
},
{
"description": "City Tax",
"name": "City Tax",
"currency": "USD",
"value": 0
}
],
"payAtProperty": [
{
"description": "Resort Fee of $30 plus tax per room per night which covers: free local, long distance and international phone calls. Choice of complimentary wine or water, or both upon check-in. Complimentary coffee & tea in our lobby each morning. Access to WiFi 24/7 for all devices. Around the clock access to our fitness center with treadmills, bikes, and weights. Storage of your luggage and your packages delivered to the hotel while you explore the city.",
"name": "Resort Fee Pay at property",
"currency": "USD",
"value": 0
}
]
}
},
"occupancy": {
"guestAges": "30,5"
},
"guests": [
{
"adult": true,
"age": null,
"email": "test@hoteltrader.com",
"firstName": "test",
"lastName": "booking",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"room test comment"
]
},
{
"cancellationDate": null,
"cancellationFee": null,
"cancelled": false,
"cancellationPolicies": [
{
"startWindowTime": "2025-01-14 16:00:00",
"endWindowTime": "2025-01-15 16:00:00",
"currency": "USD",
"cancellationCharge": 731.49,
"timeZone": "America/New_York",
"timeZoneUTC" : "-05:00"
}
],
"checkInDate": "2025-01-15",
"checkOutDate": "2025-01-18",
"clientRoomConfirmationCode": "tc-test-1406-2",
"htRoomConfirmationCode": "HT-VFBLEY-2",
"crsConfirmationCode": "KEY24N107415360",
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": null,
"refundable": true,
"roomName": "Standard | Double Queen-S2Q",
"mealplanOptions": {
"mealplanDescription": "Free Breakfast",
"mealplanCode": "BBF",
"mealplanName": "Free Breakfast"
},
"rates": {
"currency": "USD",
"netPrice": 690,
"tax": 41.49,
"grossPrice": 731.49,
"dailyPrice": [
202.4,
202.4,
202.4
],
"dailyTax": [
12.17,
12.17,
12.17
],
"payAtProperty": 90,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": "State Tax",
"name": "State Tax",
"currency": "USD",
"value": 0.09
},
{
"description": "City Tax",
"name": "City Tax",
"currency": "USD",
"value": 41.4
}
],
"payAtProperty": [
{
"description": "Resort Fee of $30 plus tax per room per night which covers: free local, long distance and international phone calls. Choice of complimentary wine or water, or both upon check-in. Complimentary coffee & tea in our lobby each morning. Access to WiFi 24/7 for all devices. Around the clock access to our fitness center with treadmills, bikes, and weights. Storage of your luggage and your packages delivered to the hotel while you explore the city.",
"name": "Resort Fee Pay at property",
"currency": "USD",
"value": 90
}
]
}
},
"occupancy": {
"guestAges": "30,5"
},
"guests": [
{
"adult": true,
"age": null,
"email": "test@hoteltrader.com",
"firstName": "test",
"lastName": "new name change",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"changing guest name"
]
},
{
"cancellationDate": null,
"cancellationFee": null,
"cancelled": false,
"cancellationPolicies": [
{
"startWindowTime": "2025-01-04 16:00:00",
"endWindowTime": "2025-01-05 16:00:00",
"currency": "USD",
"cancellationCharge": 731.49,
"timeZone": "America/New_York",
"timeZoneUTC" : "-05:00"
}
],
"checkInDate": "2025-01-05",
"checkOutDate": "2025-01-08",
"clientRoomConfirmationCode": "tc-test-1406-3",
"htRoomConfirmationCode": "HT-VFBLEY-3",
"crsConfirmationCode": null,
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": null,
"refundable": true,
"roomName": "Standard | Double Queen-S2Q",
"mealplanOptions": {
"mealplanDescription": "Free Breakfast",
"mealplanCode": "BBF",
"mealplanName": "Free Breakfast"
},
"rates": {
"currency": "USD",
"netPrice": 690,
"tax": 41.49,
"grossPrice": 731.49,
"dailyPrice": [
230,
230,
230
],
"dailyTax": [
13.83,
13.83,
13.83
],
"payAtProperty": 90,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": "State Tax",
"name": "State Tax",
"currency": "USD",
"value": 0.09
},
{
"description": "City Tax",
"name": "City Tax",
"currency": "USD",
"value": 41.4
}
],
"payAtProperty": [
{
"description": "Resort Fee of $30 plus tax per room per night which covers: free local, long distance and international phone calls. Choice of complimentary wine or water, or both upon check-in. Complimentary coffee & tea in our lobby each morning. Access to WiFi 24/7 for all devices. Around the clock access to our fitness center with treadmills, bikes, and weights. Storage of your luggage and your packages delivered to the hotel while you explore the city.",
"name": "Resort Fee Pay at property",
"currency": "USD",
"value": 90
}
]
}
},
"occupancy": {
"guestAges": "30,5"
},
"guests": [
{
"adult": true,
"age": null,
"email": "test@hoteltrader.com",
"firstName": "test",
"lastName": "booking",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"adding 3rd room to booking"
]
}
]
}
}
}
Adding a Room
For this type of modification request, all fields that are part of the Rooms object for a regular booking request are needed along with status = "BOOK" (case insensitive) at Rooms level node.
Request
{
"Modify": {
"htConfirmationCode": "HT-VCTTMJ",
"clientConfirmationCode": "tc-test-0715010",
"otaConfirmationCode": "test-client-2749",
"otaClientName": "htrader",
"specialRequests": [
"test comment",
"2 test comment"
],
"rooms": [
{
"htIdentifier": "71619102|1417121611161|151417212|121012161-10111-10171|121012161-10111-10191|161c1a1f1e18131c1-1e14161a1-14191a121-1914221-111819152c161d151c18111|1117161716101510182712191|111|5MtzhGGZRLqbyerDTATc8g==|RvyNmvpK5kegJHZaK2TYkw==",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"roomSpecialRequests": [
"room2testcomment",
"room2testcommentagain"
],
"rates": {
"netPrice": 308,
"tax": 246.4,
"grossPrice": 554.4,
"payAtProperty": 138,
"dailyPrice": [
154,
154
],
"dailyTax": [
123.2,
123.2
]
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"firstName": "test",
"lastName": "newbooking",
"email": "test@hoteltrader.com",
"adult": true,
"age": 24,
"phone": "1234567890",
"primary": true
}
],
"status": "BOOK"
}
]
}
}
Response
{
"data": {
"modify": {
"htConfirmationCode": "HT-VCTTMJ",
"clientConfirmationCode": "tc-test-0715010",
"otaConfirmationCode": "test-client-2749",
"consolidatedComments": "Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.. Reservation is refundable but nonModifiable. Minimum adult age at check in is 18 years. Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests. Room#1: A Resort Fee totaling EUR138.00 will be charged at the hotel, for the stay. Room#2: A Resort Fee totaling EUR138.00 will be charged at the hotel, for the stay. ",
"consolidatedHTMLComments": "- Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest..
- Reservation is refundable but nonModifiable.
- Minimum adult age at check in is 18 years.
- Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests.
- Room#1: A Resort Fee totaling EUR138.00 will be charged at the hotel, for the stay. Room#2: A Resort Fee totaling EUR138.00 will be charged at the hotel, for the stay.
",
"bookingDate": "2026-01-05T08:36:15.000-0500",
"specialRequests": [
"test comment",
"2 test comment"
],
"propertyDetails": {
"address": {
"address1": "700 8th Avenue",
"cityName": "New York",
"countryCode": "US",
"stateName": "New York",
"zipCode": "10036"
},
"checkInTime": "3:00 PM",
"checkOutTime": "10:00 AM",
"city": "New York",
"hotelImageUrl": null,
"latitude": "40.75905",
"longitude": "-73.98844",
"propertyId": 2270549,
"propertyName": "Dingus Property NS4",
"starRating": 4,
"shortDescription": "Test short hotel description",
"longDescription": "Test hotel long description",
"timeZone": "America/New_York",
"checkInPolicy": "Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest."
},
"aggregateGrossPrice": 1108.8,
"aggregateNetPrice": 616,
"aggregateTax": 492.8,
"aggregatePayAtProperty": 276,
"rooms": [
{
"cancellationDate": null,
"cancellationFee": null,
"cancelled": false,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-03 15:00:00",
"endWindowTime": "2026-01-07 15:00:00",
"currency": "EUR",
"cancellationCharge": 138.6,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-07 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-07",
"checkOutDate": "2026-01-09",
"clientRoomConfirmationCode": "tc-test-0715010-1",
"htRoomConfirmationCode": "HT-VCTTMJ-1",
"crsConfirmationCode": "DNGHT-VCTTMJ-1",
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": "DNGHT-VCTTMJ-1",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 308,
"tax": 246.4,
"grossPrice": 554.4,
"dailyPrice": [
154,
154
],
"dailyTax": [
123.2,
123.2
],
"payAtProperty": 138,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 28
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 110
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": false,
"age": null,
"email": "trisha@gmail.com",
"firstName": "hg",
"lastName": "kl",
"phone": "8988687",
"primary": true
},
{
"adult": false,
"age": null,
"email": "trisha1@gmail.com",
"firstName": "hj",
"lastName": "hg",
"phone": "12783",
"primary": false
}
],
"roomSpecialRequests": [
"room test commentä"
]
},
{
"cancellationDate": null,
"cancellationFee": null,
"cancelled": false,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-03 15:00:00",
"endWindowTime": "2026-01-07 15:00:00",
"currency": "EUR",
"cancellationCharge": 138.6,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-07 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-07",
"checkOutDate": "2026-01-09",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"htRoomConfirmationCode": "HT-VCTTMJ-2",
"crsConfirmationCode": null,
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": null,
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 308,
"tax": 246.4,
"grossPrice": 554.4,
"dailyPrice": [
154,
154
],
"dailyTax": [
123.2,
123.2
],
"payAtProperty": 138,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 28
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 110
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "test@hoteltrader.com",
"firstName": "test",
"lastName": "newbooking",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"room2testcomment",
"room2testcommentagain"
]
}
]
}
}
}
Cancelling a Room
This type of modification requires minimal data - htRoomConfirmationCode and clientRoomConfirmationCode. This is to identify and cancel the specified room and not modify other active rooms in the reservation.
The rooms level status node should be set to CANCEL.
Request
{
"Modify": {
"htConfirmationCode": "HT-VCTTMJ",
"clientConfirmationCode": "tc-test-0715010",
"otaConfirmationCode": "test-client-2749",
"otaClientName": "htrader",
"specialRequests": [
"test cancel room",
"2 test cancel"
],
"rooms": [
{
"clientRoomConfirmationCode": "tc-test-0715010-1",
"htRoomConfirmationCode": "HT-VCTTMJ-1",
"roomSpecialRequests": [
"cancelling room to book a new one again"
],
"status": "CANCEL"
}
]
}
}
Response
{
"data": {
"modify": {
"htConfirmationCode": "HT-VCTTMJ",
"clientConfirmationCode": "tc-test-0715010",
"otaConfirmationCode": "test-client-2749",
"consolidatedComments": "Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.. Reservation is refundable but nonModifiable. Minimum adult age at check in is 18 years. Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests. Room#2: A Resort Fee totaling EUR138.00 will be charged at the hotel, for the stay. ",
"consolidatedHTMLComments": "- Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest..
- Reservation is refundable but nonModifiable.
- Minimum adult age at check in is 18 years.
- Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests.
- Room#2: A Resort Fee totaling EUR138.00 will be charged at the hotel, for the stay.
",
"bookingDate": "2026-01-05T08:36:15.000-0500",
"specialRequests": [
"test cancel room",
"2 test cancel"
],
"propertyDetails": {
"address": {
"address1": "700 8th Avenue",
"cityName": "New York",
"countryCode": "US",
"stateName": "New York",
"zipCode": "10036"
},
"checkInTime": "3:00 PM",
"checkOutTime": "10:00 AM",
"city": "New York",
"hotelImageUrl": null,
"latitude": "40.75905",
"longitude": "-73.98844",
"propertyId": 2270549,
"propertyName": "Dingus Property NS4",
"starRating": 4,
"shortDescription": "Test short hotel description",
"longDescription": "Test hotel long description",
"timeZone": "America/New_York",
"checkInPolicy": "Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest."
},
"aggregateGrossPrice": 693,
"aggregateNetPrice": 385,
"aggregateTax": 308,
"aggregatePayAtProperty": 138,
"rooms": [
{
"cancellationDate": "2026-01-05T09:40:29.000-0500",
"cancellationFee": 138.6,
"cancelled": true,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-03 15:00:00",
"endWindowTime": "2026-01-07 15:00:00",
"currency": "EUR",
"cancellationCharge": 138.6,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-07 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-07",
"checkOutDate": "2026-01-09",
"clientRoomConfirmationCode": "tc-test-0715010-1",
"htRoomConfirmationCode": "HT-VCTTMJ-1",
"crsConfirmationCode": "DNGHT-VCTTMJ-1",
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": "DNGHT-VCTTMJ-1",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 77,
"tax": 61.6,
"grossPrice": 138.6,
"dailyPrice": [
38.5,
38.5
],
"dailyTax": [
30.8,
30.8
],
"payAtProperty": 0,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 0
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 0
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": false,
"age": null,
"email": "trisha@gmail.com",
"firstName": "hg",
"lastName": "kl",
"phone": "8988687",
"primary": true
},
{
"adult": false,
"age": null,
"email": "trisha1@gmail.com",
"firstName": "hj",
"lastName": "hg",
"phone": "12783",
"primary": false
}
],
"roomSpecialRequests": [
"cancelling room to book a new one again"
]
},
{
"cancellationDate": null,
"cancellationFee": null,
"cancelled": false,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-03 15:00:00",
"endWindowTime": "2026-01-07 15:00:00",
"currency": "EUR",
"cancellationCharge": 138.6,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-07 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-07",
"checkOutDate": "2026-01-09",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"htRoomConfirmationCode": "HT-VCTTMJ-2",
"crsConfirmationCode": "DNGHT-VCTTMJ-2",
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": "DNGHT-VCTTMJ-2",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 308,
"tax": 246.4,
"grossPrice": 554.4,
"dailyPrice": [
154,
154
],
"dailyTax": [
123.2,
123.2
],
"payAtProperty": 138,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 28
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 110
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "test@hoteltrader.com",
"firstName": "test",
"lastName": "newbooking",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"room2testcomment",
"room2testcommentagain"
]
}
]
}
}
}
Modifying a Room
As described above, modifications are further divided into 2 categories based on whether the request results in a price change for the booking. The 2 types of modifications are as follows:
Critical Modifications
This type of modification request requires all the fields that are sent as a part of a new room reservation request, along with htConfirmationCode and Rooms level status = "MODIFY".
Date Change Modification
Request
{
"Modify": {
"htConfirmationCode": "HT-VCTTMJ",
"clientConfirmationCode": "tc-test-0715010",
"otaConfirmationCode": "test-client-2749",
"otaClientName": "htrader",
"specialRequests": [
"test comment",
"2 test comment"
],
"rooms": [
{
"htIdentifier": "71619102|1417121611161|151417212|121012161-10111-10191|121012161-10111-112|101d15191d14231-1011191f1-14111b161-181a18191-151814132b121d1b101a1b1|111716171610161519131412161|111|5MtzhGGZRLqbyerDTATc8g==|RvyNmvpK5kegJHZaK2TYkw==",
"htRoomConfirmationCode": "HT-VCTTMJ-2",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"roomSpecialRequests": [
"changing checkIn, CheckOut dates for room, new stay from 5-8 jan"
],
"rates": {
"netPrice": 308,
"tax": 246.4,
"grossPrice": 554.4,
"payAtProperty": 138,
"dailyPrice": [
154,
154
],
"dailyTax": [
123.2,
123.2
]
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"firstName": "test",
"lastName": "booking",
"email": "test@hoteltrader.com",
"adult": true,
"age": 24,
"phone": "1234567890",
"primary": true
}
],
"status": "MODIFY"
}
]
}
}
Response
{
"data": {
"modify": {
"htConfirmationCode": "HT-VCTTMJ",
"clientConfirmationCode": "tc-test-0715010",
"otaConfirmationCode": "test-client-2749",
"consolidatedComments": "Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.. Reservation is refundable but nonModifiable. Minimum adult age at check in is 18 years. Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests. Room#3: Breakfast for 2 guests. Room#3: A Resort Fee totaling EUR138.00 will be charged at the hotel, for the stay. ",
"consolidatedHTMLComments": "- Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest..
- Reservation is refundable but nonModifiable.
- Minimum adult age at check in is 18 years.
- Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests. Room#3: Breakfast for 2 guests.
- Room#3: A Resort Fee totaling EUR138.00 will be charged at the hotel, for the stay.
",
"bookingDate": "2026-01-05T08:36:15.000-0500",
"specialRequests": [
"test comment",
"2 test comment"
],
"propertyDetails": {
"address": {
"address1": "700 8th Avenue",
"cityName": "New York",
"countryCode": "US",
"stateName": "New York",
"zipCode": "10036"
},
"checkInTime": "3:00 PM",
"checkOutTime": "10:00 AM",
"city": "New York",
"hotelImageUrl": null,
"latitude": "40.75905",
"longitude": "-73.98844",
"propertyId": 2270549,
"propertyName": "Dingus Property NS4",
"starRating": 4,
"shortDescription": "Test short hotel description",
"longDescription": "Test hotel long description",
"timeZone": "America/New_York",
"checkInPolicy": "Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest."
},
"aggregateGrossPrice": 831.6,
"aggregateNetPrice": 462,
"aggregateTax": 369.6,
"aggregatePayAtProperty": 138,
"rooms": [
{
"cancellationDate": "2026-01-05T09:40:30.000-0500",
"cancellationFee": 138.6,
"cancelled": true,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-03 15:00:00",
"endWindowTime": "2026-01-07 15:00:00",
"currency": "EUR",
"cancellationCharge": 138.6,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-07 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-07",
"checkOutDate": "2026-01-09",
"clientRoomConfirmationCode": "tc-test-0715010-1",
"htRoomConfirmationCode": "HT-VCTTMJ-1",
"crsConfirmationCode": "DNGHT-VCTTMJ-1",
"crsCancelConfirmationCode": "DNGHT-VCTTMJ-1",
"pmsConfirmationCode": "DNGHT-VCTTMJ-1",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 77,
"tax": 61.6,
"grossPrice": 138.6,
"dailyPrice": [
38.5,
38.5
],
"dailyTax": [
30.8,
30.8
],
"payAtProperty": 0,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 0
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 0
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": false,
"age": null,
"email": "trisha@gmail.com",
"firstName": "hg",
"lastName": "kl",
"phone": "8988687",
"primary": true
},
{
"adult": false,
"age": null,
"email": "trisha1@gmail.com",
"firstName": "hj",
"lastName": "hg",
"phone": "12783",
"primary": false
}
],
"roomSpecialRequests": [
"room test commentä"
]
},
{
"cancellationDate": "2026-01-05T09:51:43.000-0500",
"cancellationFee": 138.6,
"cancelled": true,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-03 15:00:00",
"endWindowTime": "2026-01-07 15:00:00",
"currency": "EUR",
"cancellationCharge": 138.6,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-07 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-07",
"checkOutDate": "2026-01-09",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"htRoomConfirmationCode": "HT-VCTTMJ-2",
"crsConfirmationCode": "DNGHT-VCTTMJ-2",
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": "DNGHT-VCTTMJ-2",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 77,
"tax": 61.6,
"grossPrice": 138.6,
"dailyPrice": [
38.5,
38.5
],
"dailyTax": [
30.8,
30.8
],
"payAtProperty": 0,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 0
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 0
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "test@hoteltrader.com",
"firstName": "test",
"lastName": "newbooking",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"room2testcomment",
"room2testcommentagain"
]
},
{
"cancellationDate": null,
"cancellationFee": null,
"cancelled": false,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-05 15:00:00",
"endWindowTime": "2026-01-09 15:00:00",
"currency": "EUR",
"cancellationCharge": 138.6,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-09 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-09",
"checkOutDate": "2026-01-11",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"htRoomConfirmationCode": "HT-VCTTMJ-3",
"crsConfirmationCode": null,
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": null,
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 308,
"tax": 246.4,
"grossPrice": 554.4,
"dailyPrice": [
154,
154
],
"dailyTax": [
123.2,
123.2
],
"payAtProperty": 138,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 28
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 110
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "test@hoteltrader.com",
"firstName": "test",
"lastName": "booking",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"changing checkIn, CheckOut dates for room, new stay from 5-8 jan"
]
}
]
}
}
}
Occupancy Change Modification
Request
The below example is to add a guest to an existing room
{
"Modify": {
"htConfirmationCode": "HT-VCTTMJ",
"clientConfirmationCode": "tc-test-0715010",
"otaConfirmationCode": "test-client-2749",
"otaClientName": "htrader",
"specialRequests": [
"testcomment",
"2testcomment"
],
"rooms": [
{
"htIdentifier": "71619102|1417121611161|151417212|121012161-10111-10191|121012161-10111-112|181c1114171211131-12151e1d1-141a17141-1b261c1-1d271e111613121d151e151|1117161716101815142019141|111|5MtzhGGZRLqbyerDTATc8g==|RvyNmvpK5kegJHZaK2TYkw==",
"htRoomConfirmationCode": "HT-VCTTMJ-3",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"roomSpecialRequests": [
"changingoccupancyfrom2adultsto2adults1child"
],
"rates": {
"netPrice": 374,
"tax": 448.8,
"grossPrice": 822.8,
"payAtProperty": 199,
"dailyPrice": [
187,
187
],
"dailyTax": [
224.4,
224.4
]
},
"occupancy": {
"guestAges": "30,30,5"
},
"guests": [
{
"firstName": "Trisha",
"lastName": "booking",
"email": "test@hoteltrader.com",
"adult": true,
"age": 24,
"phone": "1234567890",
"primary": true
}
],
"status": "MODIFY"
}
]
}
}
Response
{
"data": {
"modify": {
"htConfirmationCode": "HT-VCTTMJ",
"clientConfirmationCode": "tc-test-0715010",
"otaConfirmationCode": "test-client-2749",
"consolidatedComments": "Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.. Reservation is refundable but nonModifiable. Minimum adult age at check in is 18 years. Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests. Room#3: Breakfast for 2 guests. Room#3: A Resort Fee totaling EUR138.00 will be charged at the hotel, for the stay. ",
"consolidatedHTMLComments": "- Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest..
- Reservation is refundable but nonModifiable.
- Minimum adult age at check in is 18 years.
- Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests. Room#3: Breakfast for 2 guests.
- Room#3: A Resort Fee totaling EUR138.00 will be charged at the hotel, for the stay.
",
"bookingDate": "2026-01-05T08:36:15.000-0500",
"specialRequests": [
"testcomment",
"2testcomment"
],
"propertyDetails": {
"address": {
"address1": "700 8th Avenue",
"cityName": "New York",
"countryCode": "US",
"stateName": "New York",
"zipCode": "10036"
},
"checkInTime": "3:00 PM",
"checkOutTime": "10:00 AM",
"city": "New York",
"hotelImageUrl": null,
"latitude": "40.75905",
"longitude": "-73.98844",
"propertyId": 2270549,
"propertyName": "Dingus Property NS4",
"starRating": 4,
"shortDescription": "Test short hotel description",
"longDescription": "Test hotel long description",
"timeZone": "America/New_York",
"checkInPolicy": "Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest."
},
"aggregateGrossPrice": 1100,
"aggregateNetPrice": 528,
"aggregateTax": 572,
"aggregatePayAtProperty": 199,
"rooms": [
{
"cancellationDate": "2026-01-05T09:40:30.000-0500",
"cancellationFee": 138.6,
"cancelled": true,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-03 15:00:00",
"endWindowTime": "2026-01-07 15:00:00",
"currency": "EUR",
"cancellationCharge": 138.6,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-07 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-07",
"checkOutDate": "2026-01-09",
"clientRoomConfirmationCode": "tc-test-0715010-1",
"htRoomConfirmationCode": "HT-VCTTMJ-1",
"crsConfirmationCode": "DNGHT-VCTTMJ-1",
"crsCancelConfirmationCode": "DNGHT-VCTTMJ-1",
"pmsConfirmationCode": "DNGHT-VCTTMJ-1",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 77,
"tax": 61.6,
"grossPrice": 138.6,
"dailyPrice": [
38.5,
38.5
],
"dailyTax": [
30.8,
30.8
],
"payAtProperty": 0,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 0
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 0
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": false,
"age": null,
"email": "trisha@gmail.com",
"firstName": "hg",
"lastName": "kl",
"phone": "8988687",
"primary": true
},
{
"adult": false,
"age": null,
"email": "trisha1@gmail.com",
"firstName": "hj",
"lastName": "hg",
"phone": "12783",
"primary": false
}
],
"roomSpecialRequests": [
"room test commentä"
]
},
{
"cancellationDate": "2026-01-05T09:51:43.000-0500",
"cancellationFee": 138.6,
"cancelled": true,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-03 15:00:00",
"endWindowTime": "2026-01-07 15:00:00",
"currency": "EUR",
"cancellationCharge": 138.6,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-07 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-07",
"checkOutDate": "2026-01-09",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"htRoomConfirmationCode": "HT-VCTTMJ-2",
"crsConfirmationCode": "DNGHT-VCTTMJ-2",
"crsCancelConfirmationCode": "DNGHT-VCTTMJ-2",
"pmsConfirmationCode": "DNGHT-VCTTMJ-2",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 77,
"tax": 61.6,
"grossPrice": 138.6,
"dailyPrice": [
38.5,
38.5
],
"dailyTax": [
30.8,
30.8
],
"payAtProperty": 0,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 0
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 0
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "test@hoteltrader.com",
"firstName": "test",
"lastName": "newbooking",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"room2testcomment",
"room2testcommentagain"
]
},
{
"cancellationDate": null,
"cancellationFee": null,
"cancelled": false,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-05 15:00:00",
"endWindowTime": "2026-01-09 15:00:00",
"currency": "EUR",
"cancellationCharge": 205.7,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-09 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-09",
"checkOutDate": "2026-01-11",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"htRoomConfirmationCode": "HT-VCTTMJ-3",
"crsConfirmationCode": "DNGHT-VCTTMJ-3",
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": "DNGHT-VCTTMJ-3",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 374,
"tax": 448.8,
"grossPrice": 822.8,
"dailyPrice": [
187,
187
],
"dailyTax": [
224.4,
224.4
],
"payAtProperty": 199,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 28
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 110
}
]
}
},
"occupancy": {
"guestAges": "30,30,5"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "test@hoteltrader.com",
"firstName": "Trisha",
"lastName": "booking",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"changingoccupancyfrom2adultsto2adults1child"
]
}
]
}
}
}
Rateplan/Roomtype Change Modification
Request
{
"Modify": {
"htConfirmationCode": "HT-VCTTMJ",
"clientConfirmationCode": "tc-test-0715010",
"otaConfirmationCode": "test-client-2749",
"otaClientName": "htrader",
"specialRequests": [
"test comment",
"2 test comment"
],
"rooms": [
{
"htIdentifier": "71619102|1417121611171|151417212|121012161-10111-10191|121012161-10111-112|1c1e121a1f221e1-171e1b171-141a211-1b14181b1-181a111a1913191b121e141e1|111716171611141612191119131|111|5MtzhGGZRLqbyerDTATc8g==|RvyNmvpK5kegJHZaK2TYkw==",
"htRoomConfirmationCode": "HT-VCTTMJ-3",
"clientRoomConfirmationCode": "ttc-test-0715010-2",
"roomSpecialRequests": [
"changing roomtype for room, from 'Standard | Double Queen-S2Q' to 'Standard | King' and changing rateplan from HTPKG to HTOPQ"
],
"rates": {
"netPrice": 374,
"tax": 448.8,
"grossPrice": 822.8,
"payAtProperty": 199,
"dailyPrice": [
187,
187
],
"dailyTax": [
224.4,
224.4
]
},
"occupancy": {
"guestAges": "30,30,5"
},
"guests": [
{
"firstName": "test",
"lastName": "booking",
"email": "test@hoteltrader.com",
"adult": true,
"age": 24,
"phone": "1234567890",
"primary": true
}
],
"status": "MODIFY"
}
]
}
}
Response
{
"data": {
"modify": {
"htConfirmationCode": "HT-VCTTMJ",
"clientConfirmationCode": "tc-test-0715010",
"otaConfirmationCode": "test-client-2749",
"consolidatedComments": "Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.. Reservation is refundable but nonModifiable. Minimum adult age at check in is 18 years. Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests. Room#3: Breakfast for 2 guests. Room#4: Lunch is complimentary. Room#4: A Resort Fee totaling EUR199.00 will be charged at the hotel, for the stay. ",
"consolidatedHTMLComments": "- Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest..
- Reservation is refundable but nonModifiable.
- Minimum adult age at check in is 18 years.
- Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests. Room#3: Breakfast for 2 guests. Room#4: Lunch is complimentary.
- Room#4: A Resort Fee totaling EUR199.00 will be charged at the hotel, for the stay.
",
"bookingDate": "2026-01-05T08:36:15.000-0500",
"specialRequests": [
"test comment",
"2 test comment"
],
"propertyDetails": {
"address": {
"address1": "700 8th Avenue",
"cityName": "New York",
"countryCode": "US",
"stateName": "New York",
"zipCode": "10036"
},
"checkInTime": "3:00 PM",
"checkOutTime": "10:00 AM",
"city": "New York",
"hotelImageUrl": null,
"latitude": "40.75905",
"longitude": "-73.98844",
"propertyId": 2270549,
"propertyName": "Dingus Property NS4",
"starRating": 4,
"shortDescription": "Test short hotel description",
"longDescription": "Test hotel long description",
"timeZone": "America/New_York",
"checkInPolicy": "Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest."
},
"aggregateGrossPrice": 1100,
"aggregateNetPrice": 528,
"aggregateTax": 572,
"aggregatePayAtProperty": 199,
"rooms": [
{
"cancellationDate": "2026-01-05T09:40:30.000-0500",
"cancellationFee": 138.6,
"cancelled": true,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-03 15:00:00",
"endWindowTime": "2026-01-07 15:00:00",
"currency": "EUR",
"cancellationCharge": 138.6,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-07 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-07",
"checkOutDate": "2026-01-09",
"clientRoomConfirmationCode": "tc-test-0715010-1",
"htRoomConfirmationCode": "HT-VCTTMJ-1",
"crsConfirmationCode": "DNGHT-VCTTMJ-1",
"crsCancelConfirmationCode": "DNGHT-VCTTMJ-1",
"pmsConfirmationCode": "DNGHT-VCTTMJ-1",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 77,
"tax": 61.6,
"grossPrice": 138.6,
"dailyPrice": [
38.5,
38.5
],
"dailyTax": [
30.8,
30.8
],
"payAtProperty": 0,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 0
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 0
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": false,
"age": null,
"email": "trisha@gmail.com",
"firstName": "hg",
"lastName": "kl",
"phone": "8988687",
"primary": true
},
{
"adult": false,
"age": null,
"email": "trisha1@gmail.com",
"firstName": "hj",
"lastName": "hg",
"phone": "12783",
"primary": false
}
],
"roomSpecialRequests": [
"room test commentä"
]
},
{
"cancellationDate": "2026-01-05T09:51:43.000-0500",
"cancellationFee": 138.6,
"cancelled": true,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-03 15:00:00",
"endWindowTime": "2026-01-07 15:00:00",
"currency": "EUR",
"cancellationCharge": 138.6,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-07 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-07",
"checkOutDate": "2026-01-09",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"htRoomConfirmationCode": "HT-VCTTMJ-2",
"crsConfirmationCode": "DNGHT-VCTTMJ-2",
"crsCancelConfirmationCode": "DNGHT-VCTTMJ-2",
"pmsConfirmationCode": "DNGHT-VCTTMJ-2",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 77,
"tax": 61.6,
"grossPrice": 138.6,
"dailyPrice": [
38.5,
38.5
],
"dailyTax": [
30.8,
30.8
],
"payAtProperty": 0,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 0
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 0
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "test@hoteltrader.com",
"firstName": "test",
"lastName": "newbooking",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"room2testcomment",
"room2testcommentagain"
]
},
{
"cancellationDate": "2026-01-05T12:14:42.000-0500",
"cancellationFee": 0,
"cancelled": true,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-05 15:00:00",
"endWindowTime": "2026-01-09 15:00:00",
"currency": "EUR",
"cancellationCharge": 205.7,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-09 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-09",
"checkOutDate": "2026-01-11",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"htRoomConfirmationCode": "HT-VCTTMJ-3",
"crsConfirmationCode": "DNGHT-VCTTMJ-3",
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": "DNGHT-VCTTMJ-3",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 0,
"tax": 0,
"grossPrice": 0,
"dailyPrice": [
0,
0
],
"dailyTax": [
0,
0
],
"payAtProperty": 0,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 0
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 0
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 0
}
]
}
},
"occupancy": {
"guestAges": "30,30,5"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "test@hoteltrader.com",
"firstName": "Trisha",
"lastName": "booking",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"changingoccupancyfrom2adultsto2adults1child"
]
},
{
"cancellationDate": null,
"cancellationFee": null,
"cancelled": false,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-09 15:00:00",
"endWindowTime": "2026-01-09 18:00:00",
"currency": "EUR",
"cancellationCharge": 164.56,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-09 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-09",
"checkOutDate": "2026-01-11",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"htRoomConfirmationCode": "HT-VCTTMJ-4",
"crsConfirmationCode": null,
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": null,
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Lunch is complimentary",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 374,
"tax": 448.8,
"grossPrice": 822.8,
"dailyPrice": [
187,
187
],
"dailyTax": [
224.4,
224.4
],
"payAtProperty": 199,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 448.8
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 34
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 165
}
]
}
},
"occupancy": {
"guestAges": "30,30,5"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "test@hoteltrader.com",
"firstName": "test",
"lastName": "booking",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"changing roomtype for room, from 'Standard | Double Queen-S2Q' to 'Standard | King' and changing rateplan from HTPKG to HTOPQ"
]
}
]
}
}
}
2. Non-Critical Modifications
This type of modification request requires only the mandatory fields - specialRequests or roomSpecialRequests to send / change/update comments. For a guest name change request, the complete guests node should be sent with the expected occupancy count for the room.
Add Special Request for a Room
Request
{
"Modify": {
"htConfirmationCode": "HT-AO3PQA",
"clientConfirmationCode": "tc-test-0738161",
"otaConfirmationCode": "test-client-9169",
"otaClientName": "htrader",
"specialRequests": [
"test comment new one to test special requests MUMMA,test comment new one to test special requests MUMMA"
],
"rooms": [
{
"htRoomConfirmationCode": "HT-AO3PQA-1",
"clientRoomConfirmationCode": "tc-test-0738161-1",
"roomSpecialRequests": [
"room test comment new one to test special requests again"
],
"status": "MODIFY"
},
{
"htRoomConfirmationCode": "HT-AO3PQA-2",
"clientRoomConfirmationCode": "tc-test-0738161-2",
"roomSpecialRequests": [
"room test comment new one to test special requests again"
],
"status": "MODIFY"
}
]
}
}
Response
{
"data": {
"modify": {
"htConfirmationCode": "HT-AO3PQA",
"clientConfirmationCode": "tc-test-0738161",
"otaConfirmationCode": "test-client-9169",
"consolidatedComments": "Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.. Reservation is refundable but nonModifiable. Minimum adult age at check in is 18 years. Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests. Room#1: A Resort Fee totaling EUR118.00 will be charged at the hotel, for the stay. Room#2: A Resort Fee totaling EUR179.00 will be charged at the hotel, for the stay. ",
"consolidatedHTMLComments": "- Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest..
- Reservation is refundable but nonModifiable.
- Minimum adult age at check in is 18 years.
- Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests.
- Room#1: A Resort Fee totaling EUR118.00 will be charged at the hotel, for the stay. Room#2: A Resort Fee totaling EUR179.00 will be charged at the hotel, for the stay.
",
"bookingDate": "2025-12-22T10:48:51.000-0500",
"specialRequests": [
"test comment new one to test special requests MUMMA,test comment new one to test special requests MUMMA"
],
"propertyDetails": {
"address": {
"address1": "700 8th Avenue",
"cityName": "New York",
"countryCode": "US",
"stateName": "New York",
"zipCode": "10036"
},
"checkInTime": "3:00 PM",
"checkOutTime": "10:00 AM",
"city": "New York",
"hotelImageUrl": null,
"latitude": "40.75905",
"longitude": "-73.98844",
"propertyId": 2270549,
"propertyName": "Dingus Property NS4",
"starRating": 4,
"shortDescription": "Test short hotel description",
"longDescription": "Test hotel long description",
"timeZone": "America/New_York",
"checkInPolicy": "Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest."
},
"aggregateGrossPrice": 452,
"aggregateNetPrice": 220,
"aggregateTax": 232,
"aggregatePayAtProperty": 297,
"rooms": [
{
"cancellationDate": null,
"cancellationFee": null,
"cancelled": false,
"cancellationPolicies": [
{
"startWindowTime": "2025-12-23 15:00:00",
"endWindowTime": "2025-12-25 15:00:00",
"currency": "EUR",
"cancellationCharge": 72,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2025-12-25 15:00:00",
"noShowCharge": 72,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2025-12-25",
"checkOutDate": "2025-12-27",
"clientRoomConfirmationCode": "tc-test-0738161-1",
"htRoomConfirmationCode": "HT-AO3PQA-1",
"crsConfirmationCode": "DNGHT-AO3PQA-1",
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": "DNGHT-AO3PQA-1",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 80,
"tax": 64,
"grossPrice": 144,
"dailyPrice": [
40,
40
],
"dailyTax": [
32,
32
],
"payAtProperty": 118,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 64
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 8
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 110
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "tsinha@hoteltrader.com",
"firstName": "Trisha",
"lastName": "Srivastava",
"phone": "987656780",
"primary": true
}
],
"roomSpecialRequests": [
"room test comment new one to test special requests again"
]
},
{
"cancellationDate": null,
"cancellationFee": null,
"cancelled": false,
"cancellationPolicies": [
{
"startWindowTime": "2025-12-23 15:00:00",
"endWindowTime": "2025-12-25 15:00:00",
"currency": "EUR",
"cancellationCharge": 154,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2025-12-25 15:00:00",
"noShowCharge": 154,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2025-12-25",
"checkOutDate": "2025-12-27",
"clientRoomConfirmationCode": "tc-test-0738161-2",
"htRoomConfirmationCode": "HT-AO3PQA-2",
"crsConfirmationCode": "DNGHT-AO3PQA-2",
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": "DNGHT-AO3PQA-2",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 140,
"tax": 168,
"grossPrice": 308,
"dailyPrice": [
70,
70
],
"dailyTax": [
84,
84
],
"payAtProperty": 179,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 168
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 14
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 165
}
]
}
},
"occupancy": {
"guestAges": "30,30,2"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "tsinha@hoteltrader.com",
"firstName": "Manas",
"lastName": "Srivastava",
"phone": "987656780",
"primary": true
}
],
"roomSpecialRequests": [
"room test comment"
]
}
]
}
}
}
Modify the Guest Name of an Existing Room
Request
{
"Modify": {
"htConfirmationCode": "HT-VCTTMJ",
"clientConfirmationCode": "tc-test-0715010",
"otaConfirmationCode": "test-client-2749",
"otaClientName": "htrader",
"specialRequests": [
"reservation test commentä"
],
"rooms": [
{
"htRoomConfirmationCode": "HT-VCTTMJ-4",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"guests": [
{
"firstName": "Trisha",
"lastName": "Srivastava",
"email": "tsinha@hoteltrader.com",
"adult": true,
"age": 24,
"phone": "987656780",
"primary": true
}
],
"roomSpecialRequests": [
"room test commentä"
],
"status": "MODIFY"
}
]
}
}
Response
{
"data": {
"modify": {
"htConfirmationCode": "HT-VCTTMJ",
"clientConfirmationCode": "tc-test-0715010",
"otaConfirmationCode": "test-client-2749",
"consolidatedComments": "Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.. Reservation is refundable but nonModifiable. Minimum adult age at check in is 18 years. Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests. Room#3: Breakfast for 2 guests. Room#4: Lunch is complimentary. Room#4: A Resort Fee totaling EUR199.00 will be charged at the hotel, for the stay. ",
"consolidatedHTMLComments": "- Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest..
- Reservation is refundable but nonModifiable.
- Minimum adult age at check in is 18 years.
- Room#1: Breakfast for 2 guests. Room#2: Breakfast for 2 guests. Room#3: Breakfast for 2 guests. Room#4: Lunch is complimentary.
- Room#4: A Resort Fee totaling EUR199.00 will be charged at the hotel, for the stay.
",
"bookingDate": "2026-01-05T08:36:15.000-0500",
"specialRequests": [
"reservation test commentä"
],
"propertyDetails": {
"address": {
"address1": "700 8th Avenue",
"cityName": "New York",
"countryCode": "US",
"stateName": "New York",
"zipCode": "10036"
},
"checkInTime": "3:00 PM",
"checkOutTime": "10:00 AM",
"city": "New York",
"hotelImageUrl": null,
"latitude": "40.75905",
"longitude": "-73.98844",
"propertyId": 2270549,
"propertyName": "Dingus Property NS4",
"starRating": 4,
"shortDescription": "Test short hotel description",
"longDescription": "Test hotel long description",
"timeZone": "America/New_York",
"checkInPolicy": "Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest."
},
"aggregateGrossPrice": 1100,
"aggregateNetPrice": 528,
"aggregateTax": 572,
"aggregatePayAtProperty": 199,
"rooms": [
{
"cancellationDate": "2026-01-05T09:40:30.000-0500",
"cancellationFee": 138.6,
"cancelled": true,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-03 15:00:00",
"endWindowTime": "2026-01-07 15:00:00",
"currency": "EUR",
"cancellationCharge": 138.6,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-07 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-07",
"checkOutDate": "2026-01-09",
"clientRoomConfirmationCode": "tc-test-0715010-1",
"htRoomConfirmationCode": "HT-VCTTMJ-1",
"crsConfirmationCode": "DNGHT-VCTTMJ-1",
"crsCancelConfirmationCode": "DNGHT-VCTTMJ-1",
"pmsConfirmationCode": "DNGHT-VCTTMJ-1",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 77,
"tax": 61.6,
"grossPrice": 138.6,
"dailyPrice": [
38.5,
38.5
],
"dailyTax": [
30.8,
30.8
],
"payAtProperty": 0,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 0
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 0
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": false,
"age": null,
"email": "trisha@gmail.com",
"firstName": "hg",
"lastName": "kl",
"phone": "8988687",
"primary": true
},
{
"adult": false,
"age": null,
"email": "trisha1@gmail.com",
"firstName": "hj",
"lastName": "hg",
"phone": "12783",
"primary": false
}
],
"roomSpecialRequests": [
"room test commentä"
]
},
{
"cancellationDate": "2026-01-05T09:51:43.000-0500",
"cancellationFee": 138.6,
"cancelled": true,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-03 15:00:00",
"endWindowTime": "2026-01-07 15:00:00",
"currency": "EUR",
"cancellationCharge": 138.6,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-07 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-07",
"checkOutDate": "2026-01-09",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"htRoomConfirmationCode": "HT-VCTTMJ-2",
"crsConfirmationCode": "DNGHT-VCTTMJ-2",
"crsCancelConfirmationCode": "DNGHT-VCTTMJ-2",
"pmsConfirmationCode": "DNGHT-VCTTMJ-2",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 77,
"tax": 61.6,
"grossPrice": 138.6,
"dailyPrice": [
38.5,
38.5
],
"dailyTax": [
30.8,
30.8
],
"payAtProperty": 0,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 246.4
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 0
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 0
}
]
}
},
"occupancy": {
"guestAges": "30,30"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "test@hoteltrader.com",
"firstName": "test",
"lastName": "newbooking",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"room2testcomment",
"room2testcommentagain"
]
},
{
"cancellationDate": "2026-01-05T12:14:43.000-0500",
"cancellationFee": 0,
"cancelled": true,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-05 15:00:00",
"endWindowTime": "2026-01-09 15:00:00",
"currency": "EUR",
"cancellationCharge": 205.7,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-09 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-09",
"checkOutDate": "2026-01-11",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"htRoomConfirmationCode": "HT-VCTTMJ-3",
"crsConfirmationCode": "DNGHT-VCTTMJ-3",
"crsCancelConfirmationCode": "DNGHT-VCTTMJ-3",
"pmsConfirmationCode": "DNGHT-VCTTMJ-3",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Breakfast for 2 guests",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 0,
"tax": 0,
"grossPrice": 0,
"dailyPrice": [
0,
0
],
"dailyTax": [
0,
0
],
"payAtProperty": 0,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 0
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 0
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 0
}
]
}
},
"occupancy": {
"guestAges": "30,30,5"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "test@hoteltrader.com",
"firstName": "Trisha",
"lastName": "booking",
"phone": "1234567890",
"primary": true
}
],
"roomSpecialRequests": [
"changingoccupancyfrom2adultsto2adults1child"
]
},
{
"cancellationDate": null,
"cancellationFee": null,
"cancelled": false,
"cancellationPolicies": [
{
"startWindowTime": "2026-01-09 15:00:00",
"endWindowTime": "2026-01-09 18:00:00",
"currency": "EUR",
"cancellationCharge": 164.56,
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "CancellationPolicy"
}
],
"noShowPolicies": [
{
"startWindowTime": "2026-01-09 15:00:00",
"noShowCharge": 2,
"currency": "EUR",
"timeZone": "America/New_York",
"timeZoneUTC": "-05:00",
"type": "NoShowPolicy"
}
],
"checkInDate": "2026-01-09",
"checkOutDate": "2026-01-11",
"clientRoomConfirmationCode": "tc-test-0715010-2",
"htRoomConfirmationCode": "HT-VCTTMJ-4",
"crsConfirmationCode": "DNGHT-VCTTMJ-4",
"crsCancelConfirmationCode": null,
"pmsConfirmationCode": "DNGHT-VCTTMJ-4",
"refundable": true,
"roomName": "Room 1 Double Occupancy",
"mealplanOptions": {
"mealplanDescription": "Lunch is complimentary",
"mealplanCode": "RO",
"mealplanName": "Room Only"
},
"rates": {
"currency": "EUR",
"netPrice": 374,
"tax": 448.8,
"grossPrice": 822.8,
"dailyPrice": [
187,
187
],
"dailyTax": [
224.4,
224.4
],
"payAtProperty": 199,
"aggregateTaxInfo": {
"payAtBooking": [
{
"description": null,
"name": "T3",
"currency": "EUR",
"value": 448.8
}
],
"payAtProperty": [
{
"description": "",
"name": "T2",
"currency": "EUR",
"value": 34
},
{
"description": "",
"name": "T1",
"currency": "EUR",
"value": 165
}
]
}
},
"occupancy": {
"guestAges": "30,30,5"
},
"guests": [
{
"adult": true,
"age": 24,
"email": "tsinha@hoteltrader.com",
"firstName": "Trisha",
"lastName": "Srivastava",
"phone": "987656780",
"primary": true
}
],
"roomSpecialRequests": [
"room test comment"
]
}
]
}
}
}
Error
For more information on the list of error codes, see the Error Codes page.
{
"errors": [
{
"message": "Reservation Not found",
"extensions": {
"errorCode": 1011
}
}
],
"data": {
"modify": null
}
}