Amadeus · 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
TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights

Hotel Booking Room Association Structure is a JSON Structure definition published by Amadeus, describing 3 properties, of which 2 are required. It conforms to the https://json-structure.org/draft/v0/schema meta-schema.

Properties

guestReferences specialRequest hotelOfferId

Meta-schema: https://json-structure.org/draft/v0/schema

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/draft/v0/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/hotel-booking-room-association-structure.json",
  "title": "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."
    },
    "specialRequest": {
      "type": "string",
      "description": "special request to send to the reception (optional)"
    },
    "hotelOfferId": {
      "type": "string",
      "description": "Hotel offerID received in availability response, identifying the product to book."
    }
  },
  "required": [
    "guestReferences",
    "hotelOfferId"
  ]
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/hotel-booking-room-association-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.