---
title: "Retrieve descriptive details about specified hotels."
method: POST
path: "/hotels/details"
tags: ["Service"]
---

# Retrieve descriptive details about specified hotels.

`POST /hotels/details`

Retrieve hotel property information

## Headers

- `Accept-Language` string
- `concur-correlationid` string, required

## Request body

- HotelDetailsCriteria
  - `hotelCodes` HotelPropertyRef[], required — Reference Ids to hotel properties for which rate is requested
    - `chainCode` string — Chain code associated with hotel if any
    - `propertyCode` string, required — Provider's property code as given in search response
  - `requestorInfo` RequestorInfo, required — Information about POS (Point Of Sale), traveler and user associated with this request
    - `bookingForSelf` boolean — Is logged in person booking for self or on behalf of someone else
    - `loginId` string — Login ID of traveler within Concur. Only sent when available.
    - `posRequestorId` string, required — An identifier of the entity making the request (e.g. ATA/IATA/ID number)
    - `travelerUuid` string, required — UUID that identifies the traveler within Concur
    - `gdsName` 'SABRE' | 'AMADEUS' | 'TRAVELPORT' — Name of the GDS (Global Distribution System) to be used for this booking (active or passive segment). Supported values: SABRE, AMADEUS, TRAVELPORT
    - `pcc` string — Pseudo City Code or Office ID (OID) for the GDS account to be used for this booking (active or passive segment).
    - `singlePNR` boolean — Indicates if the booking should be made in a single PNR (Passenger Name Record) for all travelers. If true, all travelers will be booked under the same PNR. If false, each traveler will have their own PNR.
  - `searchSessionToken` string, uuid — Session token to be generated and provided by server on initial "search" call that can be referenced back for future api calls on the same session.

## Response `200`

Hotel descriptive info for requested properties

- HotelDetailsResponse
  - `hotelDetailsList` HotelDetails[], required
    - `hotelDescriptiveInfo` HotelDetailsHotelDescriptiveInfo, required
      - `descriptiveInfos` HotelDescriptiveInfo[], required
        - `contents` string[], required
        - `endDate` string, date — End date for descriptive info if applicable only for specific dates (e.g. for alerts or special events)
        - `otaCode` integer, required — Code based on OTA Additional Detail Type (ADT) list (https://www.opentraveldevelopersnetwork.com/code-list)
        - `startDate` string, date — Start date for descriptive info if applicable only for specific dates (e.g. for alerts or special events)
      - `mediaItems` HotelMedia[], required
        - `category` integer — OTA code describing the image as defined in OTA Picture Category Code (PIC) list
        - `description` string
        - `type` 'IMAGE' | 'VIDEO', required — Note that currently only "IMAGE" type is supported in Concur application
        - `url` string, uri, required
      - `propertyDescription` string, required
    - `propertyRef` HotelPropertyRef, required — Reference to hotel property using provider specific property code
      - `chainCode` string — Chain code associated with hotel if any
      - `propertyCode` string, required — Provider's property code as given in search response
    - `checkInTime` string — check-in time in HH:MM 24 hour format eg. 11:00
    - `checkOutTime` string — check-out time in HH:MM 24 hour format eg. 16:00.

## Other responses

- `400` — Invalid client request. Request shouldn't be retried without changing it.
- `401` — Unauthorized
- `500` — Error while processing the request. Request can be retried as is at a later time.

---

[API](https://skmtc.net/concur/apis/hotel-service-api.md) · [All operations](https://skmtc.net/concur/apis/hotel-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/concur/hotel-service-api/revisions/1fbd68eda4fc/schema)