Skip to main content
GET
List hotels

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

Literal substring search of the hotel name across all supported languages (case- and diacritics-insensitive).

Maximum string length: 200
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
amenities
string

Comma-separated hotel amenity codes. Returns hotels that have all listed amenities, for example sauna,parking. A facility can match as an own amenity or in an aquapark's includes, regardless of pricing. Filtering applies before pagination and total counts. Unknown codes return 400. See Filtering.

Maximum string length: 500
amenityCategory
enum<string>

Hotel amenity category code. Returns hotels that have at least one amenity in this category, for example wellness. See Filtering.

Available options:
health,
wellness,
dining,
services,
accessibility,
parking,
sport,
children
expand
enum<string>[]

Comma-separated expansions, for example roomTypes,amenityLabels. amenityLabels adds localized labels to amenity categories, amenities, and options, including those of embedded room types; see Labels. roomTypes embeds each hotel's enabled, non-draft room types (otherwise fetch them via GET /room-types?hotelId={hotelId}).

Available options:
roomTypes,
amenityLabels

Response

A paginated list of hotels.

data
object[]
required
pagination
object
required