Amadeus Reservations · JSON Structure

Hotel Booking Room Association Structure

Room Association represents a room booked in an hotel, the guests sleeping in this room, the hotel loyalty program if any, plus special request if any.

Type: object Properties: 3 Required: 2
BookingFlightsHotelsReservationsTravel

roomAssociation is a JSON Structure definition published by Amadeus Reservations, describing 3 properties, of which 2 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

guestReferences specialRequest hotelOfferId

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑ 
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus-reservations/refs/heads/main/json-structure/hotel-booking-room-association-structure.json",
  "name": "roomAssociation",
  "description": "Room Association represents a room booked in an hotel, the guests sleeping in this room, the hotel loyalty program if any, plus special request if any. ",
  "type": "object",
  "properties": {
    "guestReferences": {
      "type": "array",
      "description": "Array of guest references listing all the guests occupying the room.\nFor each guest, the reference provided is the id also provided in guest section, except at booking creation time (in this only case, it will be a temporary id provided by the client called tid).\nThe order of this list is important. The first one is the main guest, the one holding the reservation (and the form of payment).\nThe following references are the ones of the accompagnants, if any.",
      "items": {
        "type": "object",
        "properties": {
          "guestReference": {
            "type": "string"
          },
          "hotelLoyaltyId": {
            "type": "string",
            "description": "Hotel Chain Rewards Program Membership ID of the guest.\nTo receive your Rewards Points, access online check in, fast check out. An error is returned by the Chain if the number is invalid.\nExample Rewards Programs:\n* Marriott Bonvoy\n* Hilton Honors\n* Hyatt Rewards\n* IHG Rewards\n* Wyndham Rewards\n* Accor Live Limitless ALL\n* Best Western Rewards\n* Choice Privileges\n* Radisson Rewards\n",
            "pattern": "^[A-Z0-9-]{1,21}$",
            "minLength": 1,
            "maxLength": 21,
            "example": "3081031320523260"
          }
        },
        "required": [
          "guestReference"
        ]
      }
    },
    "specialRequest": {
      "type": "string",
      "minLength": 2,
      "description": "special request to send to the reception (optional)",
      "example": "TEST I will arrive at midnight",
      "maxLength": 120
    },
    "hotelOfferId": {
      "type": "string",
      "description": "Hotel offerID received in availability response, identifying the product to book.",
      "example": "63A93695B58821ABB0EC2B33FE9FAB24D72BF34B1BD7D707293763D8D9378FC3",
      "maxLength": 100,
      "minLength": 2,
      "pattern": "^[A-Z0-9]*$"
    }
  },
  "required": [
    "guestReferences",
    "hotelOfferId"
  ]
}