Amadeus · Schema

Hotel

Hotel location information

TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights
View JSON Schema on GitHub

JSON Schema

hotel-list-hotel-schema.json Raw ↑
{
  "$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-schema.json",
  "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"
        }
      }
    }
  ]
}