Skip to main content
Draft — not yet available. This is a work-in-progress contract. It may change before release; do not build against it.
A spa or wellness property, with its name, address, star rating, contact details, images, and indicative priceFrom. Localized fields (name, description, commercialSlogan, equipment, services) return the locale keys selected by Accept-Language.
​
id
string
required
Pattern: ^[0-9a-fA-F]{24}$
Example:

"66f16191f739705faa020001"

​
name
object
required

Localized hotel name (plain text). Falls back to the default locale (cs-CZ) when a requested locale has no value, so it is never null.

Example:
{
  "cs-CZ": "Pawlik",
  "de": "Pawlik-Aquaforum"
}
​
stars
integer | null
required
Required range: 1 <= x <= 5
Example:

4

​
address
object
required
​
phoneNumber
string | null
required
​
description
object
required

Localized description (Markdown).

Example:
{
  "cs-CZ": "Superior dvouluzkovy pokoj",
  "de": "Superior Doppelzimmer"
}
​
commercialSlogan
object
required

Localized marketing slogan (plain text).

Example:
{
  "cs-CZ": "Superior dvouluzkovy pokoj",
  "de": "Superior Doppelzimmer"
}
​
equipment
object
required

Localized equipment description.

Example:
{
  "cs-CZ": "Superior dvouluzkovy pokoj",
  "de": "Superior Doppelzimmer"
}
​
services
object
required

Localized services description.

Example:
{
  "cs-CZ": "Superior dvouluzkovy pokoj",
  "de": "Superior Doppelzimmer"
}
​
images
object[]
required
​
priceFrom
object
required

Indicative cheapest ("from") price for the hotel, or null when no active price list applies.

​
amenities
object[]

Draft — not yet implemented. The hotel's amenities. Resolve each code against GET /amenities for its label, category and scope.

Example:
[
  { "code": "wellness.sauna" },
  { "code": "connectivity.wifi" },
  { "code": "parking.parking", "quantity": 40 },
  {
    "code": "pools.indoor_pool",
    "condition": "seasonal"
  }
]
​
roomTypes
object[]

Draft. The hotel's room types. Embedded only when expand=roomTypes; otherwise fetch them via GET /room-types?hotelId={hotelId}. Each item omits the nested hotel block (it is this hotel).