Modify hotel details

API reference

Hotel

Request

Modify the details of an existing hotel booking. This API displays the list of modifications available for the same hotel. Currently, the details such as occupancy date and room type can be modified. To confirm the selected changes, use the Modify hotel booking API.

Security

Bearer

Path

pnrIdstringrequired

PNR ID of the hotel booking for which the details need to be modified.

Example:4974a66b

Bodyapplication/jsonrequired

occupancyDatesobject(Occupancy Dates)required

Occupancy values and dates for the hotel details.

corporateInfoobject(CorporateInfoV2)

Corporate information related to the hotel booking.

curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/hotel/pnrs/4974a66b/modify-details \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "occupancyDates": {
      "occupancy": [
        {
          "numAdults": 1,
          "numChildren": 0
        }
      ],
      "checkInDate": {
        "iso8601": "2017-07-21T17:32"
      },
      "checkOutDate": {
        "iso8601": "2017-07-21T17:32"
      }
    },
    "corporateInfo": {
      "preSearchAnswers": {
        "answers": [
          {
            "entityId": "string",
            "userInput": "string",
            "itemIds": [
              0
            ],
            "answers": [
              {
                "item": "string",
                "value": "string",
                "description": "string"
              }
            ],
            "customFieldType": "QUESTION",
            "questionDisplayText": "string",
            "question": {
              "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
              "name": "string",
              "questionFormat": "CHECKBOX",
              "optionInfo": {
                "source": "MANUAL",
                "sourceMetadata": {},
                "totalNumOptions": 0,
                "options": [
                  null
                ]
              },
              "isRequired": true,
              "isDisabled": true,
              "includeInItinerary": true,
              "customFieldLocations": [
                "POLICY_APPROVAL_EMAIL"
              ],
              "matchConditions": {
                "travelerConditions": {
                  "workerTypes": [],
                  "countries": [],
                  "legalEntities": [],
                  "departments": [],
                  "costCenters": [],
                  "offices": []
                },
                "travelTypes": [
                  null
                ],
                "travelRegionTypes": [
                  null
                ],
                "tripUsageTypes": [
                  null
                ]
              },
              "questionType": {
                "preSearchQuestionType": "PURPOSE_OF_TRIP",
                "preCheckoutQuestionType": "OOP_REASON_CODE"
              }
            }
          }
        ],
        "userEntitiesResponseId": "string"
      },
      "customFieldV3Responses": [
        {
          "fieldId": "84922011-b03d-4966-bc95-c5b49bc2e342",
          "fieldName": "string",
          "armId": "0fd508db-63ff-4444-bfb1-b89c43061433",
          "includeLocations": [
            "APPROVAL_EMAILS"
          ],
          "selectedOptions": [
            {
              "name": "string",
              "translatedName": "string",
              "description": "string",
              "translatedDescription": "string",
              "additionalUserInput": "string",
              "additionalInfos": [
                "string"
              ],
              "additionalInfoConfigs": [
                {}
              ],
              "optionId": "dee15a0e-f1fe-4cd8-88ac-c090810707f8"
            }
          ]
        }
      ]
    }
  }'

Responses

Bodyapplication/json

hotelDetailsKeystring

A unique identifier for the hotel details.

Example:"dummy"

hotelSpecobject(HotelSpec)required

Specification of the hotel.

roomsArray of objects(Hotel Room Data)required

List of available rooms in the hotel.

bookedRoomsArray of objects(Hotel Room Data)

List of booked rooms in the hotel, present only as part of modification details response.

occupancyDatesobject(Occupancy Dates)required

Occupancy values and dates for the hotel details.

rateStatisticsobject(Hotel Rate Statistics)

Statistical information about the hotel rates.

showOnlyBaseFareboolean

Flag to indicate if only the base fare should be shown.

preferencesArray of objects(Preference)

List of user preferences.

termsAndConditionsArray of objects(TermsAndConditions)

List of terms and conditions applicable to the booking.

ancillariesArray of objects(Hotel Ancillary)

List of available ancillaries that can be booked along with the hotel room.

virtualPaymentAvailableboolean

Indicates whether a virtual card payment source is available to the traveler for this hotel.

Example:false

distanceobject(Length)

Distance from the search point.

Response

{
  "hotelDetailsKey": "dummy",
  "hotelSpec": {
    "name": "London Heathrow Marriott Hotel",
    "address": { … },
    "coordinates": { … },
    "contactInfo": { … },
    "amenities": [ … ],
    "descriptions": [ … ],
    "imageSets": [ … ],
    "hotelId": "SPOTNANA:1001",
    "brandCode": "MC",
    "brandName": "Marriott Hotel Brands",
    "chainCode": "EM",
    "chainName": "Marriott Hotels & Resorts",
    "propertyTypes": [ … ],
    "starRating": { … },
    "additionalAmenities": [ … ],
    "checkinTime": { … },
    "checkoutTime": { … },
    "vpayInfo": { … }
  },
  "rooms": [
    { … }
  ],
  "bookedRooms": [
    { … }
  ],
  "occupancyDates": {
    "occupancy": [ … ],
    "checkInDate": { … },
    "checkOutDate": { … }
  },
  "rateStatistics": {
    "median": { … },
    "mean": { … },
    "sampleSize": 100,
    "policyType": "DEFAULT",
    "statisticalMethod": "MEDIAN",
    "preferredHotelsOnly": true
  },
  "showOnlyBaseFare": true,
  "preferences": [
    { … }
  ],
  "termsAndConditions": [
    { … }
  ],
  "ancillaries": [
    { … }
  ],
  "virtualPaymentAvailable": false,
  "distance": {
    "length": 150,
    "unit": "MILE"
  }
}