Skip to main content
A hotel contains identity, contact details, images, localized content, structured accommodation rules, meal services, medical indications, staff languages, and hotel-level amenities. Localized values return only the keys selected by Accept-Language. name falls back to the Czech value when a requested translation is missing. Other localized fields preserve the requested key and return null when its translation is missing.

​
Structured profile

shortDescription is the localized short hotel description (up to 400 characters per locale). channelContent.tagline is a localized tagline intended for sales channels (up to 100 characters per locale). accommodationRules always contains check-in and check-out ranges, the children policy, and the pets policy. The children policy includes whether children are accepted and an optional minimum age. The pets policy includes whether pets are accepted, an optional minimum stay, per-night fees in CZK and EUR, and localized conditions (up to 300 characters per locale). The feePerNight.czk and feePerNight.eur values are major-unit amounts, not Money objects. An unset time or optional numeric value is null. mealServices always contains breakfast, lunch, and dinner. Each meal reports whether it is enabled, its optional serving time, its service method (buffet or served), whether drinks are included, and a localized drinks note (up to 200 characters per locale). indications is an ordered array of medical indication codes. The hotel specializes in treating the listed areas: staffLanguages contains the ISO 639-1 codes of the languages spoken by hotel staff: cs (Czech), en (English), de (German), and ru (Russian).

​
Amenities

amenityCategories groups the hotel’s assigned structured amenities by category. Categories without assigned amenities are omitted, and the response does not contain the complete system dictionary. The category, amenity, and each selected option are returned by code only; each amenity also carries its applicable access, distance, options, opening-hour, and localized note details. Fetch GET /api/v2/amenity-categories and find the matching code under data[].amenities[] to resolve its label, parent category, supported detail fields, and every allowed amenity-specific option. See Amenity value for the exact detailKinds to response-field mapping. Fields not supported by an amenity are omitted. Add expand=amenityLabels to inline the localized category, amenity, and option labels instead of resolving them against the dictionary. priceFrom contains the cheapest available current or future room price for the room’s standard occupancy. Each currency reports the nightly room total, the total for the required minimum stay, the occupancy, and the minimum number of nights. The perNight and minimumStay totals already include any active public-channel promotion. When a promotion lowers the price, perNightOriginal and minimumStayOriginal carry the pre-discount (“was”) price; they are null otherwise. The cheapest room can differ by currency. priceFrom is null when the hotel has no usable price; an unavailable currency key is omitted.
​
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:
​
shortDescription
object
required

Localized short hotel description (plain text). Each locale value is at most 400 characters.

Example:
​
channelContent
object
required
​
stars
integer | null
required
Required range: 1 <= x <= 5
Example:

4

​
address
object
required
​
email
string<email> | null
required
​
phoneNumber
string | null
required
​
url
string<uri> | null
required
​
images
object[]
required
​
accommodationRules
object
required
​
mealServices
object
required
Example:
​
indications
enum<string>[]
required

Medical indications the hotel specializes in, in display order.

Available options:
musculoskeletal,
cardiovascular,
dermatology,
digestion_metabolism,
nervous_system,
prevention,
gynecology,
oncology_aftercare,
diabetes
​
staffLanguages
enum<string>[]
required

Languages spoken by hotel staff.

Available options:
cs,
en,
de,
ru
​
amenityCategories
object[]
required

Structured amenities assigned to this hotel, grouped by category. Categories without assigned amenities are omitted. Category, amenity, and option are returned by code only — resolve their localized labels and supported detail kinds against the amenity dictionary (GET /amenity-categories).

Example:
​
priceFrom
object | null
required

Cheapest available current or future room price for the room's standard occupancy, including an applicable public-channel promotion, or null when no usable price is available.

Example:
​
roomTypes
object[]

Draft: This field and its response shape are still in progress and may change before they are finalized.

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).