Booking Holdings · Schema

AccommodationsDetailsInput

AccommodationsDetailsInput schema from Booking.com Demand API

AccommodationsAirlinesCar RentalsHospitalityHotelsRestaurantsTravel

Properties

Name Type Description
accommodation_facilities array
accommodation_types array
accommodations array
airport string 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 brands array
city integer A signed integer number that uniquely identifies a city. The full list can be obtained by calling com
country string 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
extras array Input parameter to request for additional information about the accommodation property. It should be passed as a JSON array with one or more items.
languages array
page string Pagination token used to retrieve the next page of results. Obtained from `next_page`.
payment object Payment input information to filter results.
region integer 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
rows integer The maximum number of results to return.
View JSON Schema on GitHub

JSON Schema

demand-api-accommodations-details-input-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/booking-holdings/refs/heads/main/json-schema/demand-api-accommodations-details-input-schema.json",
  "title": "AccommodationsDetailsInput",
  "description": "AccommodationsDetailsInput schema from Booking.com Demand API",
  "type": "object",
  "properties": {
    "accommodation_facilities": {
      "type": "array",
      "items": {
        "description": "A signed integer number that uniquely identifies an accommodation property facility. Examples of facilities are: Parking, Restaurant, Room service etc. The full list can be obtained by calling <a href=\"/demand/docs/open-api/demand-api/accommodations/accommodations/constants\" target=\"_blank\">accommodations/constants</a>.",
        "type": "integer",
        "minimum": 1
      }
    },
    "accommodation_types": {
      "type": "array",
      "items": {
        "description": "A signed integer number that uniquely identifies an accommodation property type. Examples of accommodation types are: Apartment, Hostel, Hotel etc. The full list can be obtained by calling <a href=\"/demand/docs/open-api/demand-api/accommodations/accommodations/constants\" target=\"_blank\">accommodations/constants</a>.",
        "type": "integer",
        "minimum": 1
      }
    },
    "accommodations": {
      "type": "array",
      "items": {
        "description": "A signed integer number that uniquely identifies an accommodation property. The full list can be obtained by calling [accommodations/details](/demand/docs/open-api/demand-api/accommodations/accommodations/details).",
        "type": "integer",
        "minimum": 1
      },
      "maxItems": 100
    },
    "airport": {
      "description": "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>.",
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "brands": {
      "type": "array",
      "items": {
        "description": "A signed integer number that uniquely identifies an accommodation brand. Examples of brands are: Radisson Blu, WestCord Hotels, Westin etc. The full list can be obtained by calling <a href=\"/demand/docs/open-api/demand-api/accommodations/accommodations/chains\" target=\"_blank\">/accommodations/chains</a>.",
        "type": "integer",
        "minimum": 1
      }
    },
    "city": {
      "description": "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>.",
      "type": "integer"
    },
    "country": {
      "description": "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>.",
      "type": "string",
      "pattern": "^[a-z]{2}$"
    },
    "extras": {
      "description": "Input parameter to request for additional information about the accommodation property. It should be passed as a JSON array with one or more items.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "description",
          "bundles",
          "facilities",
          "payment",
          "photos",
          "policies",
          "rooms"
        ]
      }
    },
    "languages": {
      "type": "array",
      "items": {
        "description": "A [IETF language tag code](https://en.wikipedia.org/wiki/IETF_language_tag) that uniquely identifies a supported human language or dialect. **Note:** Demand API only accepts lowercase for the language codes. Examples: \"nl\" for Dutch/Nederlands or \"en-us\" for English (US). To retrieve the full list of supported languages, call the `/common/languages` endpoint in the same Demand API version you are using.",
        "type": "string",
        "pattern": "^[a-z]{2}(-[a-z]{2})?$"
      }
    },
    "page": {
      "description": "Pagination token used to retrieve the next page of results. Obtained from `next_page`.",
      "type": "string"
    },
    "payment": {
      "description": "Payment input information to filter results.",
      "properties": {
        "timing": {
          "description": "This parameter specifies that the results should only return accommodation and blocks that contain the specified payment timings.",
          "type": "string",
          "enum": [
            "pay_at_the_property",
            "pay_online"
          ]
        }
      },
      "type": "object"
    },
    "region": {
      "description": "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>.",
      "type": "integer",
      "minimum": 1
    },
    "rows": {
      "maximum": 1000,
      "description": "The maximum number of results to return.",
      "type": "integer",
      "minimum": 10,
      "default": 100
    }
  }
}