Sign in
latestOpenAPI 3.1.02026-08-10390815.4 KB

e5f3dccae7ca

Accommodations

Details

This endpoint returns detailed information on all accommodation properties matching a given search criteria. By default, only basic information is returned. <br/><br/>It is mandatory to pass one of the input parameters: accommodations, airport, city, country or region. <br/><br/>To receive extended information use the extras parameter.

post/accommodations/details

Headers

X-Affiliate-Idinteger required

Include here your Affiliate identifier number

Request body

accommodation_facilitiesinteger[]
accommodation_typesinteger[]
accommodationsinteger[]
airportstring

A three-letter code that uniquely identifies an airport as defined by the International Air Transport Association (IATA). The full list can be obtained by calling <a href="/demand/docs/open-api/demand-api/commonlocations/common/locations/airports" target="_blank">common/locations/airports</a>.

brandsinteger[]
cityinteger

A signed integer number that uniquely identifies a city. The full list can be obtained by calling <a href="/demand/docs/open-api/demand-api/commonlocations/common/locations/cities" target="_blank">common/locations/cities</a>.

countrystring

A two-letter code that uniquely identifies a country. This code is defined by the ISO 3166-1 alpha-2 standard (ISO2) as described here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2. The full list can be obtained by calling <a href="/demand/docs/open-api/demand-api/commonlocations/common/locations/countries" target="_blank">common/locations/countries</a>.

extrasstring[]

Input parameter to request for additional information about the accommodation property. It should be passed as a JSON array with one or more items.

languagesstring[]
pagestring

Pagination token used to retrieve the next page of results. Obtained from next_page.

regioninteger

A signed integer number that uniquely identifies a geographical region. Regions usually define official administrative areas within a country, but may also include multiple countries and in some cases un-official but popular designations for geographical areas. An example of a region that crosses multiple countries is the Alps in Europe. The full list can be obtained by calling <a href="/demand/docs/open-api/demand-api/commonlocations/common/locations/regions" target="_blank">common/locations/regions</a>.

rowsinteger

The maximum number of results to return.

Example request

{
  "airport": "AMS",
  "country": "nl",
  "languages": [
    "en-us"
  ]
}

Response

Successful response.

request_idstring

Uniquely identifies the request. Please provide this identifier when contacting support.

next_pagestring nullable

Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter page).

Example response

{
  "data": [
    {
      "currency": "EUR",
      "location": {
        "country": "nl"
      },
      "payment": {
        "methods": {
          "cash": true
        }
      },
      "photos": [
        {
          "main_photo": true,
          "tags": [
            "Bathroom"
          ],
          "url": {
            "large": "https://q-xx.bstatic.com/xdata/images/hotel/max1280/20934654.jpg?k=806399263699a47361bdbbefc9c872a3db03eea26c4a815f5f4df95c93e38cdb&o=",
            "standard": "https://q-xx.bstatic.com/xdata/images/hotel/max500/20934654.jpg?k=806399263699a47361bdbbefc9c872a3db03eea26c4a815f5f4df95c93e38cdb&o=",
            "thumbnail": "https://q-xx.bstatic.com/xdata/images/hotel/100x100/20934654.jpg?k=806399263699a47361bdbbefc9c872a3db03eea26c4a815f5f4df95c93e38cdb&o=",
            "thumbnail_large": "https://q-xx.bstatic.com/xdata/images/hotel/300x300/20934654.jpg?k=806399263699a47361bdbbefc9c872a3db03eea26c4a815f5f4df95c93e38cdb&o="
          }
        }
      ],
      "rating": {
        "preferred": true,
        "stars": 4
      },
      "rooms": [
        {
          "photos": [
            {
              "main_photo": true,
              "tags": [
                "Bathroom"
              ],
              "url": {
                "large": "https://q-xx.bstatic.com/xdata/images/hotel/max1280/20934654.jpg?k=806399263699a47361bdbbefc9c872a3db03eea26c4a815f5f4df95c93e38cdb&o=",
                "standard": "https://q-xx.bstatic.com/xdata/images/hotel/max500/20934654.jpg?k=806399263699a47361bdbbefc9c872a3db03eea26c4a815f5f4df95c93e38cdb&o=",
                "thumbnail": "https://q-xx.bstatic.com/xdata/images/hotel/100x100/20934654.jpg?k=806399263699a47361bdbbefc9c872a3db03eea26c4a815f5f4df95c93e38cdb&o=",
                "thumbnail_large": "https://q-xx.bstatic.com/xdata/images/hotel/300x300/20934654.jpg?k=806399263699a47361bdbbefc9c872a3db03eea26c4a815f5f4df95c93e38cdb&o="
              }
            }
          ],
          "size": 20
        }
      ],
      "spoken_languages": [
        "en-us"
      ]
    }
  ]
}