Skip to content

Get hotel details

Request

Get details for a specific hotel.

Security
Bearer
Bodyapplication/jsonrequired
hotelDetailsKeystringrequired

A unique identifier for the hotel details.

corporateInfoobject(CorporateInfoV2)

Corporate information related to the hotel booking.

occupancyDatesobject(Occupancy Dates)

Occupancy values and dates for the hotel details.

filtersobject(Hotel Details Filters)

Filters to apply when fetching hotel details.

userIdobject(Hotel User Identifier)
curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/hotel/details \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "hotelDetailsKey": "string",
    "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"
            }
          ]
        }
      ]
    },
    "occupancyDates": {
      "occupancy": [
        {
          "numAdults": 1,
          "numChildren": 0,
          "childAges": [
            4,
            7
          ],
          "numInfants": 0
        }
      ],
      "checkInDate": {
        "iso8601": "2017-07-21T17:32"
      },
      "checkOutDate": {
        "iso8601": "2017-07-21T17:32"
      }
    },
    "filters": {
      "rateTypes": [
        "PUBLISHED"
      ]
    },
    "userId": {
      "userIdType": "USER_ID",
      "userId": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      }
    }
  }'

Responses

OK

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" } }