RoomsRequest

query objectrequired

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

tokenstring

Pagination token from a previous response. It encodes the offset and a hash of the search criteria, so it is only valid for the exact same query.

RoomsRequest

{
  "token": "string"
}