GET
# HolidayCheck Hotel Name Search API - Find Hotel UUIDs

Find hotel-name matches and use their UUIDs for details and reviews.

## Overview

Find HolidayCheck hotels by name with StayAPI. Browse available matches, keep location context, and pass hotel UUIDs directly to hotel details and guest reviews.

#### Scope

query is trimmed and must contain 1–200 characters. This is hotel-name matching, not destination search. Each page contains up to 10 matches from the available result set. available\_count is the size of that returned set, not an exhaustive global hotel total; has\_more refers only to that set. A no-match query or page past the end returns HTTP 200 with hotels: []. There are no date, price, sort, language, or page-size controls. Pass hotel\_id directly to details or reviews. Search URLs use the stable /hi/{UUID} form, not a canonical hotel slug; that short URL form is not accepted by URL to Hotel ID. 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/hotels/search 

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| query | string | Required | Hotel name, 1–200 characters after trimming whitespace. |
| page | integer | Optional | Page number, at least 1. Default: 1. Fixed maximum of 10 matches per page. |

## Response schema

The response example is illustrative. Optional source values can be null. Review counts and ratings change over time.

| Field | Type | Description |
| --- | --- | --- |
| query | string | Trimmed hotel-name query. |
| hotels | array | Available hotel-name matches for this page; empty for no matches or a page past the end. |
| hotels[].hotel\_id / hotel\_name | string | Hotel UUID and published name. Use hotel\_id directly for details and reviews. |
| hotels[].location / destination\_id / destination\_name | string or null | Published location context and destination metadata, when available. These fields do not enable destination search. |
| hotels[].url | string | Stable https://www.holidaycheck.de/hi/{UUID} hotel URL; not the canonical slug URL or an accepted resolver input. |
| page / per\_page | integer | Requested page and fixed page size of 10. |
| available\_count / has\_more | integer / boolean | Count of available matches and whether another page exists within that returned set. Not a global total. |
| retrieved\_at | string | ISO timestamp for this response. |

## Errors and limitations

Errors use RFC 7807 Problem Details with `provider: "holidaycheck"` and a correlation id.

- **400** : query is empty or exceeds 200 characters after trimming.
- **422** : missing query or invalid page; page must be an integer of at least 1.
- **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/hotels/search?query=Alexa+Hotel&page=1" \
  -H "X-API-Key: YOUR_API_KEY"
```

Response

```
{
  "query": "Alexa Hotel",
  "hotels": [
    {
      "hotel_id": "c6b63919-17b1-317d-a9e7-e69dbe195f2e",
      "hotel_name": "Alexa Hotel",
      "location": "Göhren auf Rügen",
      "destination_id": null,
      "destination_name": null,
      "url": "https://www.holidaycheck.de/hi/c6b63919-17b1-317d-a9e7-e69dbe195f2e"
    }
  ],
  "page": 1,
  "per_page": 10,
  "available_count": 1,
  "has_more": false,
  "retrieved_at": "2026-09-28T10:00:00Z"
}
```

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