# Resorts

> Look up North American ski resorts by country, region, status or name, get one by slug with its operating area and provenance, see which SNOTEL stations relate to it, or download the whole registry as CSV, JSON or GeoJSON.

The resort registry lists the downhill ski areas of the United States, Canada and Mexico. It is built from [OpenSkiData](https://openskidata.org), which derives from OpenStreetMap and Skimap.org, and enriched from Wikidata. It is its own dataset: a resort says nothing about SNOTEL stations, and no station is assumed to represent a resort. Which stations matter to a resort is a separate read, [the resort's stations](#stations-relevant-to-a-resort), that labels each one as computed or reviewed.

The registry is licensed under the [Open Database License](https://opendatacommons.org/licenses/odbl/1-0/). Every response carries a `license` block; show its `attribution` wherever you show the data, and share what you build from it alike. See [resort registry](https://opensnotel.com/docs/data/resorts.md) for where the data comes from and how identity works.

## List resorts

`GET /api/v1/resorts` returns a page of the resorts the sources list now, ordered by `id`.

```bash
curl 'https://opensnotel.com/api/v1/resorts?region=US-ID&status=operating&limit=1'
```

```json
{
  "data": [
    {
      "id": 100,
      "slug": "pebble-creek",
      "name": "Pebble Creek",
      "countryCode": "US",
      "regionCode": "US-ID",
      "regionName": "Idaho",
      "locality": null,
      "latitude": 42.77376,
      "longitude": -112.15168,
      "website": "https://www.pebblecreekskiarea.com/",
      "status": "operating",
      "activities": { "downhill": true, "nordic": false },
      "elevation": { "baseM": 1944.7, "summitM": 2594.7, "verticalM": 650 },
      "liftCount": 3,
      "downhillRunCount": 58,
      "identifiers": {
        "openstreetmap": ["relation/4851664"],
        "skimap": ["478"],
        "wikidata": ["Q7158509"]
      },
      "updatedAt": "2026-10-25T15:49:52.302Z",
      "sourceUpdatedAt": "2026-10-25T02:47:59.470Z"
    }
  ],
  "page": { "limit": 1, "nextCursor": "eyJhIjoxMDB9" },
  "license": {
    "license": "ODbL-1.0",
    "licenseName": "Open Database License (ODbL) v1.0",
    "licenseUrl": "https://opendatacommons.org/licenses/odbl/1-0/",
    "attribution": "Data from OpenSkiData / OpenSkiMap.org, © OpenStreetMap contributors (ODbL), Skimap.org, Who's On First, © Mapterhorn; Wikidata (CC0)",
    "sources": [
      {
        "name": "OpenSkiData / OpenSkiMap.org",
        "url": "https://openskidata.org",
        "license": "ODbL-1.0"
      },
      {
        "name": "OpenStreetMap contributors",
        "url": "https://www.openstreetmap.org/copyright",
        "license": "ODbL-1.0"
      },
      { "name": "Skimap.org", "url": "https://skimap.org", "license": null },
      {
        "name": "Who's On First",
        "url": "https://whosonfirst.org",
        "license": null
      },
      {
        "name": "Mapterhorn",
        "url": "https://mapterhorn.com",
        "license": null
      },
      {
        "name": "Wikidata",
        "url": "https://www.wikidata.org",
        "license": "CC0-1.0"
      }
    ]
  },
  "meta": { "generatedAt": "2026-10-25T16:00:55.536Z" }
}
```

| Parameter | Meaning                                                                                     |
| --------- | ------------------------------------------------------------------------------------------- |
| `country` | ISO 3166-1 alpha-2 code: `US`, `CA` or `MX`.                                                |
| `region`  | ISO 3166-2 code, such as `US-ID` or `CA-BC`.                                                |
| `status`  | `operating`, `disused`, `abandoned`, `proposed`, `never_opened` or `unknown`.               |
| `q`       | Part of the name, case-insensitive, at least two characters.                                |
| `limit`   | Resorts per page, 1 to 500, default 100.                                                    |
| `cursor`  | The `nextCursor` of the previous page. Treat it as an opaque string; it is null at the end. |

Every status is listed unless you filter: the registry keeps abandoned and proposed areas, and an area the sources give no status is `unknown` rather than left out. A list never includes the operating-area polygon; the resort itself and the [GeoJSON dataset](https://opensnotel.com/docs/data/resorts.md) do.

## One resort

`GET /api/v1/resorts/{resort}` returns one resort by its slug, with its operating area, which source supplied each field, and every upstream record behind it. The operating area is always a GeoJSON `MultiPolygon` (one mapped polygon is a MultiPolygon of one), or `null` when only a point is mapped.

```bash
curl 'https://opensnotel.com/api/v1/resorts/bogus-basin-mountain-recreation-area'
```

The polygon is shortened here; the real one has 62 vertices.

```json
{
  "data": {
    "id": 389,
    "slug": "bogus-basin-mountain-recreation-area",
    "name": "Bogus Basin Mountain Recreation Area",
    "countryCode": "US",
    "regionCode": "US-ID",
    "regionName": "Idaho",
    "locality": null,
    "latitude": 43.76903,
    "longitude": -116.09322,
    "website": "https://bogusbasin.org",
    "status": "operating",
    "activities": { "downhill": true, "nordic": true },
    "elevation": { "baseM": 1758.3, "summitM": 2304.6, "verticalM": 546.3 },
    "liftCount": 11,
    "downhillRunCount": 117,
    "identifiers": {
      "openstreetmap": ["way/1470441271"],
      "skimap": ["487"],
      "wikidata": ["Q4937866"]
    },
    "updatedAt": "2026-10-25T15:49:52.302Z",
    "sourceUpdatedAt": "2026-10-25T02:47:59.470Z",
    "geometry": {
      "type": "MultiPolygon",
      "coordinates": [
        [
          [
            [-116.104549, 43.756342],
            [-116.103068, 43.750384],
            [-116.102613, 43.749871],
            [-116.104549, 43.756342]
          ]
        ]
      ]
    },
    "fieldSources": {
      "name": "openskidata",
      "countryCode": "openskidata",
      "regionCode": "openskidata",
      "regionName": "openskidata",
      "location": "openskidata",
      "geometry": "openskidata",
      "website": "openskidata",
      "status": "openskidata",
      "activities": "openskidata",
      "elevation": "openskidata",
      "liftCount": "openskidata",
      "downhillRunCount": "openskidata"
    },
    "sources": [
      {
        "source": "openskidata",
        "id": "f0fca4018306a921928ebc2f04cfd1ac82ba1ef2",
        "url": null,
        "firstSeenAt": "2026-10-25T15:49:52.302Z",
        "lastSeenAt": "2026-10-25T15:56:24.172Z",
        "sourceUpdatedAt": "2026-10-25T02:47:59.470Z"
      },
      {
        "source": "openstreetmap",
        "id": "way/1470441271",
        "url": "https://www.openstreetmap.org/way/1470441271",
        "firstSeenAt": "2026-10-25T15:49:52.302Z",
        "lastSeenAt": "2026-10-25T15:56:24.172Z",
        "sourceUpdatedAt": "2026-10-25T02:47:59.470Z"
      },
      {
        "source": "skimap",
        "id": "487",
        "url": "https://skimap.org/skiareas/view/487",
        "firstSeenAt": "2026-10-25T15:49:52.302Z",
        "lastSeenAt": "2026-10-25T15:56:24.172Z",
        "sourceUpdatedAt": "2026-10-25T02:47:59.470Z"
      },
      {
        "source": "wikidata",
        "id": "Q4937866",
        "url": "https://www.wikidata.org/wiki/Q4937866",
        "firstSeenAt": "2026-10-25T15:56:21.825Z",
        "lastSeenAt": "2026-10-25T15:56:24.172Z",
        "sourceUpdatedAt": "2026-10-25T15:56:23.979Z"
      }
    ],
    "removedAt": null
  },
  "resolvedFrom": null,
  "license": {
    "license": "ODbL-1.0",
    "licenseName": "Open Database License (ODbL) v1.0",
    "licenseUrl": "https://opendatacommons.org/licenses/odbl/1-0/",
    "attribution": "Data from OpenSkiData / OpenSkiMap.org, © OpenStreetMap contributors (ODbL), Skimap.org, Who's On First, © Mapterhorn; Wikidata (CC0)",
    "sources": []
  },
  "meta": { "generatedAt": "2026-10-25T16:00:55.536Z" }
}
```

`sources` in the `license` block is shortened here too; it is the same list as in every response.

- **Slugs are stable.** A slug is assigned once and never regenerated when a name changes. If a slug is ever changed by a reviewed correction, or the resort is folded into another by an upstream merge, the old slug still answers with the resort it now belongs to, and `resolvedFrom` gives the slug you asked for with `reason` `renamed` or `merged`. Use `id` or `slug` from the response as the key you store.
- **Removed resorts.** A resort the sources stop listing is not deleted: it disappears from the list, and its own address still answers with `removedAt` set.
- **Elevation and counts are mapped, not official.** `elevation` and the lift and run counts come from the lifts and downhill runs mapped in OpenStreetMap, in meters. They are null when nothing is mapped, which says nothing about what exists on the hill.
- **Field sources.** `fieldSources` names the source of each canonical field: `openskidata`, `wikidata` (it fills a missing website) or `override`, a reviewed correction.

A slug that is not lower-case words joined by dashes answers `400` with `invalid_parameter`; one no resort has ever had answers `404` with `resort_not_found`. See [errors](https://opensnotel.com/docs/api/errors.md).

## Stations relevant to a resort

`GET /api/v1/resorts/{resort}/stations` returns the SNOTEL stations that relate to a resort, and why. It reads a layer kept apart from the registry: the resort record never holds station data, and a station never holds resort data. Each entry is one of two kinds, named by `source`:

- **`curated`**: a reviewed statement that the station matters to the resort, with its `relationship` and a `rationale` in the reviewer's words. `representative` means the station is a good proxy for the resort's snow; `same_mountain`, `secondary` and `nearby` say less.
- **`candidate`**: computed from coordinates alone: one of the up to five reporting SNOTEL stations within 50 km of the resort's point, ranked by distance (`rank` 1 is nearest). A candidate's `relationship` is always `nearby` and it has no `rationale`. It is advisory: the nearest station can sit on the far side of a ridge or a thousand meters lower, so never present a candidate as representing the resort.

```bash
curl 'https://opensnotel.com/api/v1/resorts/bogus-basin-mountain-recreation-area/stations'
```

The curated mapping here is illustrative.

```json
{
  "resort": {
    "id": 389,
    "slug": "bogus-basin-mountain-recreation-area",
    "name": "Bogus Basin Mountain Recreation Area"
  },
  "data": [
    {
      "station": { "triplet": "978:ID:SNTL", "name": "Bogus Basin" },
      "source": "curated",
      "relationship": "representative",
      "rank": null,
      "distanceKm": 1.42,
      "elevationDifferenceM": 174.1,
      "rationale": "On the resort's upper mountain, at mid-mountain elevation.",
      "reviewedAt": "2026-10-25"
    },
    {
      "station": { "triplet": "978:ID:SNTL", "name": "Bogus Basin" },
      "source": "candidate",
      "relationship": "nearby",
      "rank": 1,
      "distanceKm": 1.42,
      "elevationDifferenceM": 174.1,
      "rationale": null,
      "reviewedAt": null
    },
    {
      "station": { "triplet": "637:ID:SNTL", "name": "Mores Creek Summit" },
      "source": "candidate",
      "relationship": "nearby",
      "rank": 2,
      "distanceKm": 28.65,
      "elevationDifferenceM": 101.2,
      "rationale": null,
      "reviewedAt": null
    }
  ],
  "resolvedFrom": null,
  "license": {
    "license": "ODbL-1.0",
    "licenseName": "Open Database License (ODbL) v1.0",
    "licenseUrl": "https://opendatacommons.org/licenses/odbl/1-0/",
    "attribution": "Data from OpenSkiData / OpenSkiMap.org, © OpenStreetMap contributors (ODbL), Skimap.org, Who's On First, © Mapterhorn; Wikidata (CC0)",
    "sources": []
  },
  "meta": { "generatedAt": "2026-10-25T16:00:55.536Z" }
}
```

- **Order.** Curated mappings come first, then candidates nearest first. A station can appear twice, once reviewed and once computed.
- **Distances and elevations.** `distanceKm` is the great-circle distance from the resort's representative point. `elevationDifferenceM` is the station's elevation minus the resort's mapped base elevation, in meters (positive: the station is higher), and null when either is unknown.
- **Active only.** A mapping that was withdrawn or rejected in review, or whose station stopped reporting, is left out. A removed resort has none, and a resort with no reporting station within 50 km and no reviewed mapping returns an empty `data`.
- **Slugs.** Old and merged slugs resolve as they do for the resort, with `resolvedFrom`.
- **Then read the station.** Pass a `station.triplet` to the [station reads](https://opensnotel.com/docs/api/stations.md), such as its [Snowpack Context](https://opensnotel.com/docs/api/snowpack.md).

The mappings are refreshed after each weekly registry sync, which also picks up stations the catalog has added or retired since.

## Download the registry

`GET /api/v1/datasets/{file}` returns every listed resort in one file. The registry is a couple of thousand rows, so the files are small and cached like any other read.

| File                       | Format                                                                                                        |
| -------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `resorts.csv`              | One row per resort. Identifiers are semicolon-separated; an empty field is a missing value.                   |
| `resorts.json`             | The resorts in the list shape above, with the license and the build they came from.                           |
| `resorts.geojson`          | A FeatureCollection: each resort's mapped operating area, or its point when only a point is mapped.           |
| `resorts.datapackage.json` | A [Frictionless data package](https://datapackage.org) describing the three files, their columns and license. |

Each file's response links the license (`Link: <…>; rel="license"`) and the data package (`rel="describedby"`), so a CSV, which has nowhere to carry them, still travels with its terms. The JSON and GeoJSON files carry the `license` block themselves.

```bash
curl 'https://opensnotel.com/api/v1/datasets/resorts.csv'
```

```csv
id,slug,name,country_code,region_code,region_name,locality,latitude,longitude,website,status,downhill,nordic,base_elevation_m,summit_elevation_m,vertical_m,lift_count,downhill_run_count,openstreetmap_ids,skimap_ids,wikidata_ids,updated_at,source_updated_at
100,pebble-creek,Pebble Creek,US,US-ID,Idaho,,42.77376,-112.15168,https://www.pebblecreekskiarea.com/,operating,true,false,1944.7,2594.7,650,3,58,relation/4851664,478,Q7158509,2026-10-25T15:49:52.302Z,2026-10-25T02:47:59.470Z
389,bogus-basin-mountain-recreation-area,Bogus Basin Mountain Recreation Area,US,US-ID,Idaho,,43.76903,-116.09322,https://bogusbasin.org,operating,true,true,1758.3,2304.6,546.3,11,117,way/1470441271,487,Q4937866,2026-10-25T15:49:52.302Z,2026-10-25T02:47:59.470Z
```

`build` in the JSON file says which OpenSkiData build the registry was made from, with that file's SHA-256, so the dataset can be traced to its source:

```bash
curl 'https://opensnotel.com/api/v1/datasets/resorts.json'
```

```json
{
  "name": "snotel-ski-resorts",
  "title": "Open SNOTEL ski resort registry (North America)",
  "version": "791ee6c223da120f",
  "updatedAt": "2026-10-25T15:56:21.825Z",
  "count": 1483,
  "data": [
    {
      "id": 100,
      "slug": "pebble-creek",
      "name": "Pebble Creek",
      "countryCode": "US",
      "regionCode": "US-ID",
      "regionName": "Idaho",
      "locality": null,
      "latitude": 42.77376,
      "longitude": -112.15168,
      "website": "https://www.pebblecreekskiarea.com/",
      "status": "operating",
      "activities": { "downhill": true, "nordic": false },
      "elevation": { "baseM": 1944.7, "summitM": 2594.7, "verticalM": 650 },
      "liftCount": 3,
      "downhillRunCount": 58,
      "identifiers": {
        "openstreetmap": ["relation/4851664"],
        "skimap": ["478"],
        "wikidata": ["Q7158509"]
      },
      "updatedAt": "2026-10-25T15:49:52.302Z",
      "sourceUpdatedAt": "2026-10-25T02:47:59.470Z"
    }
  ],
  "build": {
    "syncedAt": "2026-10-25T15:56:24.715Z",
    "openskidataUrl": "https://tiles.openskimap.org/geojson/ski_areas.geojson",
    "openskidataBuiltAt": "2026-10-25T02:47:59.470Z",
    "openskidataSha256": "a767524b346d67f6ea62bff7b5ea920b086a52514582124a2a9ace695b57fab1"
  },
  "license": {
    "license": "ODbL-1.0",
    "licenseName": "Open Database License (ODbL) v1.0",
    "licenseUrl": "https://opendatacommons.org/licenses/odbl/1-0/",
    "attribution": "Data from OpenSkiData / OpenSkiMap.org, © OpenStreetMap contributors (ODbL), Skimap.org, Who's On First, © Mapterhorn; Wikidata (CC0)",
    "sources": []
  }
}
```

Only one resort and none of the license sources are shown here. A file name that is not one of the four answers `404` with `not_found`.

### Versions

The files are a function of the registry alone: the same registry always gives the same bytes, and nothing in them depends on when they were asked for. Each carries a `version`, a hash of the published records, which changes only when a resort does.

- `GET /api/v1/datasets/resorts.csv` is always the current file. It is cached for about an hour and sent with the version as its `ETag`, so `If-None-Match` answers `304` until the registry changes.
- `GET /api/v1/datasets/resorts.csv?version=791ee6c223da120f` is that version at an address whose content never changes, cached for good (`immutable`). The data package lists each file at its versioned address with the file's SHA-256, so a download can be pinned and checked.
- Only the current registry is kept. Once it changes, an older version answers `404` with `not_found`, and `details.currentVersion` names the version to use.

## Next

- [Resort registry](https://opensnotel.com/docs/data/resorts.md): Where the ski resort registry comes from, how a resort keeps a stable id and slug, which of its fields are derived, and the ODbL license and attribution to show.
- [Errors](https://opensnotel.com/docs/api/errors.md): Handle API errors: the one error shape every endpoint returns, each code with its HTTP status, and what to do about it.

Canonical page: https://opensnotel.com/docs/api/resorts
