---
title: "API reference (OpenAPI 3.1)"
url: "https://data.skiresort.cz/docs/api"
lang: "cs"
schemaVersion: "2.1.0"
release: "m-fbe49f5fc6e5"
---

# API reference (OpenAPI 3.1)

Interaktivní reference veřejného API v2 generovaná z OpenAPI 3.1.

API v2 · schemaVersion 2.1.0 · release m-fbe49f (2026-10-21T20:50:15+02:00)

## Operace

Interaktivní reference (Scalar) se načítá ze `/openapi.json`. Bez JavaScriptu použijte přímo [openapi.json](https://data.skiresort.cz/openapi.json) nebo [openapi.yaml](https://data.skiresort.cz/openapi.yaml). Sloupec „Pro agenty“ = operace bez `x-agent-hidden` (doporučený výběr pro function calling).

| operationId | Cesta | Popis | Pro agenty |
| --- | --- | --- | --- |
| getApiIndex | GET /api/v2 | Index API v2 (kolekce, pohledy, odkazy na OpenAPI, dokumentaci a MCP) | ano |
| getResort | GET /api/v2/resort | Resort (singleton) s agregáty a tvrzeními zdrojů | ano |
| getAreaStatus | GET /api/v2/areas/{id}/status | Živý stav jednoho areálu | ano |
| getStatusOverview | GET /api/v2/status | Živý přehled provozu po areálech | ano |
| listWeatherObservations | GET /api/v2/weather | Pozorování: teploty z kamer s výškou a časem snímku, sníh | ano |
| listPrices | GET /api/v2/prices | Ceníky: cenová období, hladiny a ceny (offer) | ano |
| listAgeCategorySets | GET /api/v2/age-categories | Věkové kategorie podle sezóny s kontrolou pokrytí roků narození | ano |
| getEntity | GET /api/v2/entities/{id} | Libovolná entita podle kanonického ID nebo aliasu | ano |
| search | GET /api/v2/search | Fulltext přes názvy, aliasy, označení a glosář (bez diakritiky) | ano |
| getLatestRelease | GET /api/v2/releases/latest | Metadata aktuálního releasu | – |
| getQualityReport | GET /api/v2/quality | Kvalita dat: kontroly QC-\*, konflikty zdrojů, mezery, čerstvost | – |
| listAreas | GET /api/v2/areas | Areál – seznam | ano |
| getArea | GET /api/v2/areas/{id} | Areál – detail | ano |
| listLifts | GET /api/v2/lifts | Lanovka / vlek – seznam | ano |
| getLift | GET /api/v2/lifts/{id} | Lanovka / vlek – detail | ano |
| listSlopes | GET /api/v2/slopes | Sjezdovka – seznam | ano |
| getSlope | GET /api/v2/slopes/{id} | Sjezdovka – detail | ano |
| listSnowparks | GET /api/v2/snowparks | Snowpark – seznam | – |
| getSnowpark | GET /api/v2/snowparks/{id} | Snowpark – detail | – |
| listCrosscountryTrails | GET /api/v2/crosscountry-trails | Běžecká trať – seznam | – |
| getCrosscountryTrail | GET /api/v2/crosscountry-trails/{id} | Běžecká trať – detail | – |
| listSkitourRoutes | GET /api/v2/skitour-routes | Skialpová / turistická trasa – seznam | – |
| getSkitourRoute | GET /api/v2/skitour-routes/{id} | Skialpová / turistická trasa – detail | – |
| listSledRuns | GET /api/v2/sled-runs | Sáňkařská dráha – seznam | – |
| getSledRun | GET /api/v2/sled-runs/{id} | Sáňkařská dráha – detail | – |
| listParkings | GET /api/v2/parkings | Parkoviště – seznam | – |
| getParking | GET /api/v2/parkings/{id} | Parkoviště – detail | – |
| listPois | GET /api/v2/pois | Místo / služba na místě – seznam | ano |
| getPoi | GET /api/v2/pois/{id} | Místo / služba na místě – detail | – |
| listServices | GET /api/v2/services | Služba – seznam | – |
| getService | GET /api/v2/services/{id} | Služba – detail | – |
| listAttractions | GET /api/v2/attractions | Atrakce – seznam | – |
| getAttraction | GET /api/v2/attractions/{id} | Atrakce – detail | – |
| listSummerAttractions | GET /api/v2/summer-attractions | Letní atrakce – seznam | – |
| getSummerAttraction | GET /api/v2/summer-attractions/{id} | Letní atrakce – detail | – |
| listSkibusLines | GET /api/v2/skibus-lines | Linka skibusu – seznam | – |
| getSkibusLine | GET /api/v2/skibus-lines/{id} | Linka skibusu – detail | – |
| listRoutes | GET /api/v2/routes | Trasa (léto) – seznam | – |
| getRoute | GET /api/v2/routes/{id} | Trasa (léto) – detail | – |
| listBusStops | GET /api/v2/bus-stops | Zastávka (skibus / výletní bus) – seznam | – |
| getBusStop | GET /api/v2/bus-stops/{id} | Zastávka (skibus / výletní bus) – detail | – |
| listWebcams | GET /api/v2/webcams | Webkamera – seznam | – |
| getWebcam | GET /api/v2/webcams/{id} | Webkamera – detail | – |
| listWeatherStations | GET /api/v2/weather-stations | Meteostanice – seznam | – |
| getWeatherStation | GET /api/v2/weather-stations/{id} | Meteostanice – detail | – |
| listOrganizations | GET /api/v2/organizations | Organizace – seznam | – |
| getOrganization | GET /api/v2/organizations/{id} | Organizace – detail | – |
| listContacts | GET /api/v2/contacts | Kontakt – seznam | – |
| getContact | GET /api/v2/contacts/{id} | Kontakt – detail | – |
| listSeasons | GET /api/v2/seasons | Sezóna – seznam | – |
| getSeason | GET /api/v2/seasons/{id} | Sezóna – detail | – |
| listSeasonPeriods | GET /api/v2/season-periods | Cenové období sezóny – seznam | – |
| getSeasonPeriod | GET /api/v2/season-periods/{id} | Cenové období sezóny – detail | – |
| listProducts | GET /api/v2/products | Produkt – seznam | ano |
| getProduct | GET /api/v2/products/{id} | Produkt – detail | ano |
| listOffers | GET /api/v2/offers | Nabídka / cena – seznam | – |
| getOffer | GET /api/v2/offers/{id} | Nabídka / cena – detail | – |
| getAgeCategory | GET /api/v2/age-categories/{id} | Věková kategorie – detail | – |
| listAgeCategorySetEntities | GET /api/v2/age-category-sets | Sada věkových kategorií – seznam | – |
| getAgeCategorySet | GET /api/v2/age-category-sets/{id} | Sada věkových kategorií – detail | – |
| listPriceLists | GET /api/v2/price-lists | Ceník – seznam | – |
| getPriceList | GET /api/v2/price-lists/{id} | Ceník – detail | – |
| listPriceTiers | GET /api/v2/price-tiers | Cenová hladina – seznam | – |
| getPriceTier | GET /api/v2/price-tiers/{id} | Cenová hladina – detail | – |
| listSalesChannels | GET /api/v2/sales-channels | Prodejní kanál – seznam | – |
| getSalesChannel | GET /api/v2/sales-channels/{id} | Prodejní kanál – detail | – |
| listDiscounts | GET /api/v2/discounts | Sleva / pravidlo – seznam | – |
| getDiscount | GET /api/v2/discounts/{id} | Sleva / pravidlo – detail | – |
| listPrograms | GET /api/v2/programs | Program / aktivita – seznam | – |
| getProgram | GET /api/v2/programs/{id} | Program / aktivita – detail | – |
| listGlossaryTerms | GET /api/v2/glossary | Pojem glosáře – seznam | ano |
| getGlossaryTerm | GET /api/v2/glossary/{id} | Pojem glosáře – detail | ano |
| listFaq | GET /api/v2/faq | Častá otázka – seznam | – |
| getFaq | GET /api/v2/faq/{id} | Častá otázka – detail | – |
| listGuides | GET /api/v2/guides | Průvodce – seznam | – |
| getGuide | GET /api/v2/guides/{id} | Průvodce – detail | – |
| listPolicies | GET /api/v2/policies | Pravidlo / podmínka – seznam | – |
| getPolicy | GET /api/v2/policies/{id} | Pravidlo / podmínka – detail | – |
| listDocuments | GET /api/v2/documents | Dokument – seznam | – |
| getDocument | GET /api/v2/documents/{id} | Dokument – detail | – |
| listNews | GET /api/v2/news | Novinka – seznam | – |
| getNews | GET /api/v2/news/{id} | Novinka – detail | – |
| listEvents | GET /api/v2/events | Akce – seznam | – |
| getEvent | GET /api/v2/events/{id} | Akce – detail | – |
| getWebPageJsonLd | GET /api/v2/jsonld | JSON-LD pro stránku www/leto.skiresort.cz | – |
| getWebRobotsTxt | GET /api/v2/web/robots.txt | robots.txt pro www/leto.skiresort.cz | – |
| getWebLlmsTxt | GET /api/v2/web/llms.txt | llms.txt pro www/leto.skiresort.cz | – |
| getWebPages | GET /api/v2/web/pages | Stránky webu s dateModified faktů (pro sitemap lastmod) | – |

## Dokumentace

- [Data Hub pro agentury a vývojáře](https://data.skiresort.cz/docs) – Co Data Hub obsahuje, jak číst identifikátory, stavy, čas, cache, verze a licence – s příklady volání.
- [API reference (OpenAPI 3.1)](https://data.skiresort.cz/docs/api) – Interaktivní reference veřejného API v2 generovaná z OpenAPI 3.1.
- [Datový slovník](https://data.skiresort.cz/docs/data-dictionary) – Typy entit a jejich atributy z registru domény: jednotky, vrstvy, rodiny, časovost a mapování.
- [Číselníky](https://data.skiresort.cz/docs/codelists) – Kódy typů lanovek, obtížností, stavů, relací, důvodů, sezónních fází, kategorií služeb a druhů zdrojů.
- [Glosář pojmů](https://data.skiresort.cz/docs/glossary) – Pojmy resortu (SkiTour, Flexiskipas, sKiosek…) s definicemi z aktuálního releasu.
- [Pro AI agenty: MCP, OpenAPI a llms.txt](https://data.skiresort.cz/docs/mcp) – Read-only MCP server, nástroje, limity a jak citovat data.
- [Changelog](https://data.skiresort.cz/docs/changelog) – Změny produktu a schématu API v2.
- [Licence a atribuce](https://data.skiresort.cz/docs/licence) – Za jakých podmínek lze data použít a jak uvádět zdroje.
- [Migrace z API v1 na v2](https://data.skiresort.cz/docs/migrace-v1-v2) – Mapování polí a identifikátorů v1 → v2 a harmonogram ukončení v1.