{
"$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-airports-input-schema.json",
"title": "AirportsInput",
"description": "AirportsInput schema from Booking.com Demand API",
"type": "object",
"properties": {
"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 common/locations/airports.",
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"city": {
"description": "A signed integer number that uniquely identifies a city. The full list can be obtained by calling common/locations/cities.",
"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 common/locations/countries.",
"type": "string",
"pattern": "^[a-z]{2}$"
},
"district": {
"description": "A signed integer number that uniquely identifies a district. Typically, districts define known areas within a city. The full list can be obtained by calling common/locations/districts.",
"type": "integer",
"minimum": 1
},
"landmark": {
"description": "A signed integer number that uniquely identifies a relevant geographical landmark, like a monument or a natural attraction. The full list can be obtained by calling common/locations/landmarks.",
"type": "integer",
"minimum": 1
},
"languages": {
"type": "array",
"items": {
"description": "An IETF language tag code that uniquely identifies a supported human language or dialect as described here: https://en.wikipedia.org/wiki/IETF_language_tag. Note that in v3 the whole tag is always lowercase. 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})?$"
},
"default": [
"en-gb"
]
},
"page": {
"description": "Pagination token used to retrieve the next page of results. Obtained from `next_page`.",
"type": "string"
},
"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 common/locations/regions.",
"type": "integer",
"minimum": 1
},
"rows": {
"maximum": 1000,
"description": "The maximum number of results to return.",
"type": "integer",
"minimum": 10,
"default": 100
}
}
}