{
"code": "aquapark",
"proximity": "nearby",
"proximityMeters": 250,
"access": "included",
"openingHours": {
"continuous": false,
"blocks": [
{
"days": [
"monday",
"tuesday",
"wednesday"
],
"from": "09:00",
"to": "21:00"
}
]
}
}Amenity value
A structured amenity selected for a hotel.
hotel.amenityCategories[].amenities[] by both hotel endpoints. Hotel
amenities are grouped by category, and categories without assigned amenities
are omitted. Its code references an amenity nested in one of the category
groups returned by the amenity dictionary. The remaining
properties describe access, distance, options, opening hours, and a localized
guest note.
To interpret the value, find the matching code in
GET /api/v2/amenity-categories under data[].amenities[]. The parent
category provides the amenity’s category and the matching entry’s
detailKinds determines which properties are included. Properties that are
not supported by that amenity are omitted.
category is returned once on the parent hotel amenity group, by code. The
amenity’s label and detailKinds are dictionary metadata and are not repeated
inside each hotel’s amenity value by default. Request
expand=amenityLabels to inline the localized label on the
category, the amenity, and each selected option.
Each localized note value is limited to 200 characters.
| Dictionary detail kind | Meaningful amenity value field |
|---|---|
proximity | proximity and proximityMeters; the distance is non-null only when proximity is nearby |
access | access |
options | amenity-specific options selected for the hotel, by code |
opening_hours | openingHours |
note | localized note |
detailKinds: [], the amenity is presence-only and
its value contains only code.
For an aquapark with
detailKinds: [proximity, access, opening_hours], a hotel response can
contain:
{
"code": "aquapark",
"proximity": "nearby",
"proximityMeters": 250,
"access": "included",
"openingHours": {
"continuous": false,
"blocks": [
{
"days": ["monday", "tuesday", "wednesday"],
"from": "09:00",
"to": "21:00"
}
]
}
}
detailKinds include options, the
amenity dictionary lists every available option. The hotel
value contains only the selected options, by code:
{
"code": "sauna",
"options": [{ "code": "finnish" }, { "code": "steam" }]
}
expand=amenityLabels each selected option also carries its
localized label:
{
"code": "sauna",
"options": [
{ "code": "finnish", "label": { "cs-CZ": "Finská sauna", "en": "Finnish sauna" } },
{ "code": "steam", "label": { "cs-CZ": "Parní lázeň", "en": "Steam bath" } }
]
}
detailKinds remain present even when they are not filled:
scalars are null, arrays are empty, opening hours use
{ "continuous": false, "blocks": [] }, and requested localized note values are
null. Requested localized keys follow Accept-Language.
proximity says where the amenity is: in-hotel (inside the hotel building),
connecting (an adjacent building linked by an internal passage), or nearby
(a short distance away, with proximityMeters giving the approximate distance).
access says whether using the amenity costs extra: included (covered by the
stay price), conditional (included subject to stated conditions), or paid
(available for an additional charge).A structured amenity assigned to a hotel. Hotel responses contain only assigned amenities. Apart from code (and label with expand=amenityLabels), only the fields mapped from the corresponding entry under the amenity dictionary response data[].amenities[] are present.
References an Amenity.code.
"sauna"
Localized amenity label. Present only with expand=amenityLabels.
Show child attributes
Show child attributes
{
"cs-CZ": "Český text",
"de": "Deutscher Text"
}
Where the amenity is located relative to the hotel. Present when detailKinds includes proximity; null when supported but not filled. in-hotel is inside the hotel building, connecting is an adjacent building linked by an internal passage, and nearby is a short distance away (see proximityMeters).
in-hotel, connecting, nearby Present with proximity. Contains a distance when proximity is nearby; otherwise null.
0 <= x <= 1000000Present when detailKinds includes access. Null when supported but not filled. included means no additional charge, conditional means inclusion depends on stated conditions, and paid means an additional charge applies.
included, conditional, paid Amenity-specific choices selected for this hotel, by code only. Present when detailKinds includes options. Empty when the amenity supports choices but none are selected. Resolve labels against the dictionary.
Show child attributes
Show child attributes
Present when detailKinds includes opening_hours. When supported but not filled, returns continuous: false with an empty blocks array.
Show child attributes
Show child attributes
Present when detailKinds includes note. Localized supplementary information for guests. Locale values are at most 200 characters and are null when the requested translation is not filled.
Show child attributes
Show child attributes
{
"cs-CZ": "Český text",
"de": "Deutscher Text"
}