---
title: "Data Hub for agencies and developers"
url: "https://data.skiresort.cz/en/docs"
lang: "en"
schemaVersion: "2.2.0"
release: "m-603f548a1278"
---

# Data Hub for agencies and developers

What the Data Hub of SkiResort ČERNÁ HORA – PEC contains, where to find the API, OpenAPI, MCP and llms.txt, licence and contact.

API v2 · schemaVersion 2.2.0 · release m-603f54 (2026-10-22T11:05:15+02:00) · [Česká dokumentace](https://data.skiresort.cz/docs)

## What the Data Hub is

The Data Hub is the **verified source of truth** about the ski resort SkiResort ČERNÁ HORA – PEC: ski areas, lifts, slopes, cross-country trails, services and places, ski buses, products (ski passes), age categories, price lists and a glossary. It serves the resort's website and e-shop (agencies), the resort's own channels (TV panorama, displays, apps) and AI assistants.

Every value is a **claim** with its source (URL, verbatim excerpt, retrieval time, confidence). Source priority rules select the published value; conflicts are never resolved silently (`_conflicts`, [quality report](https://data.skiresort.cz/api/v2/quality)). An **immutable release** is published – the API, fact pages, `llms-full.txt` and MCP read the same release, so they say the same thing.

## Addresses

| Channel | Address | For |
|---|---|---|
| API v2 (JSON) | [https://data.skiresort.cz/api/v2](https://data.skiresort.cz/api/v2) | websites, e-shop, apps, integrations |
| OpenAPI 3.1 | [https://data.skiresort.cz/openapi.json](https://data.skiresort.cz/openapi.json) · [YAML](https://data.skiresort.cz/openapi.yaml) | client generation, function calling |
| Fact pages (HTML / Markdown) | [https://data.skiresort.cz/en](https://data.skiresort.cz/en) | search engines, AI search, people |
| llms.txt / llms-full.txt | [https://data.skiresort.cz/llms.txt](https://data.skiresort.cz/llms.txt) · [llms-full.txt](https://data.skiresort.cz/llms-full.txt) | coding and browsing agents |
| MCP (read-only, Streamable HTTP) | `https://data.skiresort.cz/mcp` | AI assistants (Claude, ChatGPT…) |
| Live status | [https://data.skiresort.cz/api/v2/status](https://data.skiresort.cz/api/v2/status) · [https://data.skiresort.cz/en/status](https://data.skiresort.cz/en/status) | operations today |
| Latest release | [https://data.skiresort.cz/api/v2/releases/latest](https://data.skiresort.cz/api/v2/releases/latest) | data version |

## Quick start

Reading requires **no authentication**, CORS is `*`, responses are cacheable (send `If-None-Match` with the ETag → `304`). Language: `?lang=en` or `Accept-Language`; a missing translation falls back to Czech and the response says so (`meta.notes`, `Content-Language`).

```bash
curl -s 'https://data.skiresort.cz/api/v2/lifts?area=cerna-hora&lang=en'
curl -s 'https://data.skiresort.cz/api/v2/status?area=pec&lang=en'
curl -s -H 'Accept: application/ld+json' 'https://data.skiresort.cz/api/v2/lifts/lift:cerna-hora:a1'   # JSON-LD (schema.org)
curl -s 'https://data.skiresort.cz/en/lifts/cerna-hora/a1.md'                                           # Markdown fact page
```

Identifiers have the form `{type}:{area}:{designation}` (`lift:cerna-hora:a1`) and are never reused; use the ID as the key, not the name. **`unknown` does not mean closed** – after `validUntil` without confirmation the API returns `status: unknown` with `lastKnown`. Errors are `application/problem+json` (RFC 9457).

## OpenAPI and MCP

- **OpenAPI 3.1**: [openapi.json](https://data.skiresort.cz/openapi.json) – operations marked `x-stage: stable` are covered by the [version policy](https://data.skiresort.cz/docs/politika-verzi) (additive changes only; removals announced with ≥ 6 months overlap and `Deprecation`/`Sunset` headers). Clients must ignore unknown fields. Interactive reference: [https://data.skiresort.cz/docs/api](https://data.skiresort.cz/docs/api).
- **MCP**: read-only server at `https://data.skiresort.cz/mcp` (JSON-RPC over Streamable HTTP, no authentication) with tools for live status, lifts, slopes, prices, age categories, FAQ, glossary and search. Every answer carries the release ID and attribution – cite the fact page URL. Details (in Czech): [https://data.skiresort.cz/docs/mcp](https://data.skiresort.cz/docs/mcp).
- Schema version: `2.2.0`; data dictionary: [https://data.skiresort.cz/docs/data-dictionary.json](https://data.skiresort.cz/docs/data-dictionary.json).

## Licence and attribution

- **The resort's own data**: see the terms of use – `meta.license` in API responses and [https://data.skiresort.cz/docs/licence](https://data.skiresort.cz/docs/licence); attribute “SkiResort ČERNÁ HORA – PEC (MEGA PLUS s.r.o.), data.skiresort.cz”.
- **Holidayinfo (Sitour CZ)**: operational data under a contract between MEGA PLUS s.r.o. and Sitour CZ – show “Data source: www.holidayinfo.cz, (c) Sitour CZ”.
- **OpenStreetMap / OpenSkiMap**: © OpenStreetMap contributors, ODbL 1.0.
- Display `meta.attributions` from each response (Data Hub and the sources used in it).

## Contact and reporting data errors

Report a wrong value with the entity ID and the fact page URL (every page has a section “How this data is produced”). A dedicated Data Hub contact for agencies is being set up; until then use the operator contact at [www.skiresort.cz](https://www.skiresort.cz/). Full documentation (in Czech): [https://data.skiresort.cz/docs](https://data.skiresort.cz/docs).