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