{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/hotel-list-hotel-search-response-schema.json", "title": "HotelSearchResponse", "description": "HotelSearchResponse schema from Hotel List", "type": "object", "properties": { "data": { "type": "array", "items": { "title": "Hotel", "description": "Hotel location information", "allOf": [ { "title": "Location_Hotel", "description": "Hotel, inheriting from Location", "allOf": [ { "type": "object", "description": "Description of a particular point or place in physical space", "title": "Location", "properties": { "subtype": { "type": "string", "description": "Location sub-type (e.g. airport, port, rail-station, restaurant, atm...)" }, "name": { "type": "string", "description": "Label associated to the location (e.g. Eiffel Tower, Madison Square)", "example": "Eiffel Tower" }, "timeZoneName": { "type": "string", "description": "Olson format name (TZ) of the location time zone (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)", "example": "Europe/Paris" }, "iataCode": { "type": "string", "description": "IATA location code", "example": "PAR" }, "address": { "type": "object", "description": "Address information", "title": "Address", "properties": { "countryCode": { "type": "string", "description": "ISO 3166-1 country code", "pattern": "[a-zA-Z]{2}" } } }, "geoCode": { "type": "object", "description": "Geographic coordinates describing the position of any location on the surface of Earth", "properties": { "latitude": { "type": "number", "format": "float", "description": "Latitude of the position expressed in decimal degrees (WSG 84), e.g. 6.244203. A positive value denotes northern hemisphere or the equator, and a negative value denotes southern hemisphere. The number of digits to represent the precision of the coordinate.", "minimum": -90, "exclusiveMinimum": false, "maximum": 90, "exclusiveMaximum": false, "example": 48.85837 }, "longitude": { "type": "number", "format": "float", "description": "Longitude of the position expressed in decimal degrees (WSG 84), e.g. -75.581211. A positive value denotes east longitude or the prime meridian, and a negative value denotes west longitude. The number of digits to represent the precision of the coordinate.", "minimum": -180, "exclusiveMinimum": false, "maximum": 180, "exclusiveMaximum": false, "example": 2.294481 } }, "title": "GeoCode" } } }, { "type": "object", "description": "Hotel Content", "title": "Hotel", "properties": { "hotelId": { "type": "string", "pattern": "^[A-Z0-9]{8}$", "example": "ADPAR001", "description": "Amadeus Property Code (8 chars)\n" }, "chainCode": { "type": "string", "pattern": "^[A-Z]{2}$", "example": "AD", "description": "Brand (RT...) or Merchant (AD...) (Amadeus 2 chars Code)\n" }, "name": { "type": "string", "example": "Hotel de Paris", "description": "Hotel Name" } } }, { "type": "object" } ] }, { "type": "object", "properties": { "distance": { "title": "Distance", "type": "object", "description": "Distance is designed to express a distance reprensentation with its value unit and state unlimited or not.", "properties": { "unit": { "type": "string", "title": "Unit", "description": "Unit type.", "enum": [ "NIGHT", "PIXELS", "KILOGRAMS", "POUNDS", "CENTIMETERS", "INCHES", "BITS_PER_PIXEL", "KILOMETERS", "MILES", "BYTES", "KILOBYTES" ] }, "value": { "type": "number", "description": "Decimal distance value" }, "displayValue": { "type": "string" }, "isUnlimited": { "type": "string", "description": "Conveys whether the distance is limited or not, if unlimited all the other properties should not be provided." } } }, "last_update": { "type": "string", "description": "Last time the content was updated by a provider.", "format": "date-time" } } } ] } }, "meta": { "type": "object", "description": "Meta information about the returned object(s) in \"data\"", "title": "Meta", "properties": { "count": { "type": "integer", "format": "int64", "description": "Total number of object(s) retrieved", "minimum": 0, "exclusiveMinimum": false, "example": 1 }, "sort": { "type": "array", "description": "Sorting fields criteria and their associated priority and direction. Sorting priority is indicated by the order of the strings within the array. E.g. sort=title,size means that items are ordered by title and then, as a second ordering by size. A '-' sign before the search criteria indicates a descending ordering direction (Z to A), whereas no sign indicates a ascending direction (A to Z). E.g. sort=-title mean that the objects are ordered by title in reverse order (Z to A).", "items": { "type": "string" } }, "links": { "type": "object", "title": "Links", "description": "Links related to the returned object(s)", "properties": { "self": { "type": "string", "format": "url", "description": "Link to the same page.", "example": "https://example.com/resource" }, "first": { "type": "string", "format": "url", "description": "Link to the first page.", "example": "https://example.com/resource" }, "prev": { "type": "string", "format": "url", "description": "Link to the previous page.", "example": "https://example.com/resource" }, "next": { "type": "string", "format": "url", "description": "Link to the next page.", "example": "https://example.com/resource" }, "last": { "type": "string", "format": "url", "description": "Link to the last page.", "example": "https://example.com/resource" } } } } } } }