Skip to main content
GET
List room types

Authorizations

X-SpaPortal-Public-Key
string
header
required

See Authentication for how to obtain and send your public key.

Headers

Accept-Language
string

Comma-separated BCP 47 language tags selecting which locale keys localized fields return. When omitted or *, all locale keys are returned. Inside a list, * adds the locales you do not list, at its own quality value. See Localization for details.

Example:

"cs-CZ,de"

X-Request-Id
string

Optional client-provided request identifier echoed in error responses.

Query Parameters

limit
integer
default:25

Number of records to return. See Pagination.

Required range: 1 <= x <= 100
cursor
string

Cursor from the previous page's pagination.nextCursor. See Pagination.

Maximum string length: 2000
hotelId
string

Filter by hotel id.

Pattern: ^[0-9a-fA-F]{24}$
disabled
enum<string>
default:false

Use false (the default) for enabled room types, true for disabled room types, or all for both. The filter applies before pagination and totals.

Available options:
false,
true,
all
occupancy
integer

Filter room types by their exact standard occupancy, the number of guests included in the base price. Pass an integer in the query string, for example ?occupancy=2, to return room types whose response contains occupancy.standard: 2. This filter does not match maximum capacity or a specific guest party.

Required range: 1 <= x <= 10
code
string

Filter by exact room type code.

Maximum string length: 200

Search the room type name (case- and diacritics-insensitive). To match a room type code, use code.

Maximum string length: 200
expand
enum<string>[]

Comma-separated expansions. hotel embeds the hotel's id, name, and stars. amenityLabels adds localized labels to amenity categories and amenities; see Labels. You can request both.

Available options:
hotel,
amenityLabels
sort
enum<string>
default:createdAt:desc

Orders by unique record id descending or ascending. IDs generally follow creation order; this is not a separate timestamp sort. Keep the sort and filters unchanged while paging. Cursors do not freeze a snapshot when records change between requests.

Available options:
createdAt:desc,
createdAt:asc
unitType
enum<string>[]

Match any of the comma-separated unit type codes.

Available options:
single,
double_double,
double_twin,
double_either,
triple,
quad,
family,
suite,
studio,
apartment
tier
enum<string>[]

Match any of the comma-separated tier codes.

Available options:
economy,
economy_plus,
standard,
standard_plus,
komfort,
komfort_plus,
superior,
deluxe
amenities
string[]

Comma-separated room type amenity codes. Returns room types that have all listed amenities, for example balcony,bathtub or parking,welcome_drink. Matches room assignments only; hotel amenities are not inherited by this filter. Unknown codes return 400. See Filtering.

amenityCategory
enum<string>

Room type amenity category code. Returns room types that have at least one amenity in this category, for example view or inclusions. See Filtering.

Available options:
bathroom,
equipment,
accessibility,
view,
kitchen,
inclusions

Response

A paginated list of room types.

data
object[]
required
pagination
object
required