HolidayCheck Hotel Details API - Property Information
Read hotel information, descriptions, grouped amenities, and rating summaries by UUID.
Overview
Read HolidayCheck hotel details with StayAPI: address, location, contact information, descriptions, amenity groups, check-in times, star classification, and ratings.
Scope
Use the hotel UUID directly, including IDs returned by Hotel Name Search or URL to Hotel ID. star_rating is the property's star classification and star_rating_source identifies its published source; neither is the guest rating. summary.rating stays on the native six-point scale and recommendation_percent is a percentage. Missing values remain null and missing descriptions or amenities are empty arrays. Text and check-in/check-out values retain their published wording; no translation or language control is offered. There are no dates, prices, room availability, or photo gallery fields. No caching guarantee is advertised.
Authentication
Send your StayAPI key in the X-API-Key header. Each successful call costs one credit. Successful requests return JSON; failures use RFC 7807 Problem Details.
Endpoint URL
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| hotel_id | string | Required | Hotel UUID from name search, a supported hotel URL, or URL to Hotel ID. |
Response schema
The response example is illustrative. Optional source values can be null. Review counts and ratings change over time.
| Field | Type | Description |
|---|---|---|
| hotel_id / hotel_name / url | string | Hotel UUID, published name, and canonical /hi/{slug}/{UUID} hotel URL. |
| star_rating / star_rating_source | number or null / string or null | Published star classification and its source; separate from the guest rating. |
| address | string or null | Published address as text. |
| location.city / region / country / continent | string or null | Published geographic context. |
| location.latitude / longitude | number or null | Coordinates when available. |
| contact.phone / email | string or null | Published hotel contact information. |
| description_sections | array | Published descriptions with source, key, and text strings. Empty when unavailable. |
| amenity_groups | array | Structured amenity groups with category_key, category_name, subcategory_name, group_id, name, and items. |
| amenity_groups[].items | array | Amenities with string id and nullable name. A null item name is not replaced with the group name; the group name may carry the meaning. |
| check_in / check_out | string or null | Published arrival and departure text; may include wording, not just a time. |
| summary.rating / rating_scale | number or null / integer | Native guest rating when available; rating_scale is always 6. |
| summary.recommendation_percent / total_reviews | number or null / integer | Recommendation percentage and total published reviews. |
| retrieved_at | string | ISO timestamp for this response. |
Errors and limitations
Errors use RFC 7807 Problem Details with provider: "holidaycheck" and a correlation id.
- 422: missing or invalid hotel UUID.
- 404: the hotel is confirmed missing.
- 500: the response could not be interpreted.
- 502: HolidayCheck data is unavailable or access was blocked.
- 503: temporarily rate-limited or unavailable; honor
Retry-Afterwhen supplied. - 504: the request timed out.
- 401 / 402 / 429: check your API key, available credits, and account rate limit.