GET
# 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

GET https://api.stayapi.com/v1/holidaycheck/hotel/details 

## 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-After` when supplied.
- **504** : the request timed out.
- **401 / 402 / 429** : check your API key, available credits, and account rate limit.

## Related HolidayCheck endpoints

[Find hotels by name](/docs/endpoints/holidaycheck/hotels-search)[Read hotel details](/docs/endpoints/holidaycheck/hotel-details)[Extract a hotel UUID from a URL](/docs/endpoints/holidaycheck/url-to-id)[Read hotel reviews and rating summaries](/docs/endpoints/holidaycheck/hotel-reviews)

Request

```curl
curl -X GET "https://api.stayapi.com/v1/holidaycheck/hotel/details?hotel_id=c6b63919-17b1-317d-a9e7-e69dbe195f2e" \
  -H "X-API-Key: YOUR_API_KEY"
```

Response

```
{
  "hotel_id": "c6b63919-17b1-317d-a9e7-e69dbe195f2e",
  "hotel_name": "Alexa Hotel",
  "url": "https://www.holidaycheck.de/hi/alexa-hotel/c6b63919-17b1-317d-a9e7-e69dbe195f2e",
  "star_rating": 3.5,
  "star_rating_source": "HSU",
  "address": "Poststraße 10\r\n18586\r\nOstseebad Göhren\r\nDeutschland",
  "location": {
    "city": "Göhren auf Rügen",
    "region": "Mecklenburg-Vorpommern",
    "country": "Deutschland",
    "continent": "Europa",
    "latitude": 54.34173,
    "longitude": 13.73761
  },
  "contact": {
    "phone": "+49 3830 86663100",
    "email": "info@alexahotel.de"
  },
  "description_sections": [
    {
      "source": "OWNER",
      "key": "LOCATION",
      "text": "zentral, am Ortseingang, ca. 650 Meter vom Strand"
    }
  ],
  "amenity_groups": [
    {
      "category_key": "CATEGORY_FACILITIES",
      "category_name": "Ausstattung",
      "subcategory_name": "Wellness",
      "group_id": "c9271100-7ad1-39bd-a77f-ac0987d97812",
      "name": "Sauna",
      "items": [
        {
          "id": "4c56b06a-caec-35f8-bbf0-22d4fdb6c9f9",
          "name": null
        }
      ]
    }
  ],
  "check_in": "ab 15:00 Uhr",
  "check_out": "bis 11:00 Uhr",
  "summary": {
    "rating": 4.779031254194159,
    "rating_scale": 6,
    "recommendation_percent": 88.30421228502881,
    "total_reviews": 336
  },
  "retrieved_at": "2026-09-28T15:02:56.307137Z"
}
```

```json
{
  "type": "about:blank",
  "title": "Invalid Input",
  "status": 422,
  "detail": "Invalid HolidayCheck input.",
  "provider": "holidaycheck",
  "instance": "/v1/holidaycheck/hotel/details",
  "correlation_id": "example-correlation-id"
}
```