RoomQuery

At least one of connectionCode, providerCode, roomCodes, roomRefs or hotelCodes is required. Without a scope the request is rejected with 400. Do not combine roomRefs with flat roomCodes (ambiguous).

anyOf

0-item-properties

1-item-properties

2-item-properties

3-item-properties

4-item-properties

connectionCodestring

Connection code in the form {orgCode}-{providerCode}-{id}. Resolves to a provider and scopes the query. A code that does not resolve returns 400.

providerCodestring

roomCodesstring[]

roomRefs object[]

Multi-provider room lookup by (providerCode, roomCodes) pairs. Each entry scopes its room codes to that provider. Mutually exclusive with flat roomCodes.

Array [

providerCodestringrequired

Provider that owns the room codes

roomCodesstring[]required

Provider-specific room codes for this provider

]

hotelCodesstring[]

Provider hotel codes to scope the query. Also required for cross-provider room content fill (hotel-base scope); without it fill is skipped.

languagestring

Language tag for the returned room texts. Fallback chain: exact tag, same base language, English, then every language we hold. Omit it to receive all languages.

Example: es

maxSizeinteger

RoomQuery

{
  "connectionCode": "string",
  "providerCode": "string",
  "roomCodes": [
    "string"
  ],
  "roomRefs": [
    {
      "providerCode": "string",
      "roomCodes": [
        "string"
      ]
    }
  ],
  "hotelCodes": [
    "string"
  ],
  "language": "es",
  "maxSize": 0
}