GET
# HolidayCheck URL to Hotel ID API - Extract Hotel UUIDs

Extract the hotel UUID from a HolidayCheck property or review-listing URL.

## Overview

Extract a HolidayCheck hotel UUID from a hotel or review-listing URL with StayAPI. Get the lowercase ID and normalized URL for paginated hotel review requests.

#### Scope

Extraction does not verify that the hotel exists. Accepts exact holidaycheck.de, holidaycheck.com, holidaycheck.at, or holidaycheck.ch hosts, with optional www, and paths /hi/{slug}/{uuid}, /hr/{slug}/{uuid}, or /hr/{uuid}. Individual /hrd/ review URLs are not supported. Query parameters and fragments are removed. Pass the returned hotel\_id directly to Hotel Details or Hotel Reviews. The short /hi/{uuid} URLs returned by name search are not accepted here; use their hotel\_id directly.

#### 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/url-to-id 

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| url | string | Required | Full supported HolidayCheck HTTPS URL containing a hotel UUID. Credentials and explicit ports, including 443, are rejected. |

## 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 | string | Lowercase hotel UUID; extraction does not establish hotel existence. |
| url | string | Normalized supplied URL with query parameters and fragment removed. |

## Errors and limitations

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

- **400** : unsupported or malformed HolidayCheck URL.
- **422** : missing required URL parameter.
- **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/url-to-id?url=https%3A%2F%2Fwww.holidaycheck.de%2Fhi%2Falexa-hotel%2Fc6b63919-17b1-317d-a9e7-e69dbe195f2e" \
  -H "X-API-Key: YOUR_API_KEY"
```

Response

```
{
  "hotel_id": "c6b63919-17b1-317d-a9e7-e69dbe195f2e",
  "url": "https://www.holidaycheck.de/hi/alexa-hotel/c6b63919-17b1-317d-a9e7-e69dbe195f2e"
}
```

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