Skip to main content
GET
List hotels
Draft: The roomTypes response field and expand=roomTypes behavior are still in progress. Their response shape may change before they are finalized.

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, all locale keys are returned. 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

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

Maximum string length: 200
sort
enum<string>
default:createdAt:desc

Sort order by creation time: createdAt:desc returns the newest records first, createdAt:asc the oldest. Records are ordered by their id, which increases with creation time, giving a stable total order that keeps cursor pagination exact.

Available options:
createdAt:desc,
createdAt:asc
amenities
string

Comma-separated amenity codes; returns only hotels that have ALL listed amenities (AND semantics). E.g. sauna,parking.

Maximum string length: 500
amenityCategory
enum<string>

Returns hotels that have any amenity in this category (e.g. wellness).

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

Comma-separated list of expansions (for example expand=amenityLabels or expand=roomTypes,amenityLabels). amenityLabels inlines the localized category, amenity, and option labels in amenityCategories, so no dictionary lookup is needed. roomTypes (draft, response shape may change) embeds each hotel's 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