Skip to content
Open Snotel home
API

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, 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, that labels each one as computed or reviewed.

The registry is licensed under the Open Database License. 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 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.

curl 'https://opensnotel.com/api/v1/resorts?region=US-ID&status=operating&limit=1'
{
  "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" }
}
ParameterMeaning
countryISO 3166-1 alpha-2 code: US, CA or MX.
regionISO 3166-2 code, such as US-ID or CA-BC.
statusoperating, disused, abandoned, proposed, never_opened or unknown.
qPart of the name, case-insensitive, at least two characters.
limitResorts per page, 1 to 500, default 100.
cursorThe 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 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.

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

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

{
  "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.

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.
curl 'https://opensnotel.com/api/v1/resorts/bogus-basin-mountain-recreation-area/stations'

The curated mapping here is illustrative.

{
  "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, such as its Snowpack Context.

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.

FileFormat
resorts.csvOne row per resort. Identifiers are semicolon-separated; an empty field is a missing value.
resorts.jsonThe resorts in the list shape above, with the license and the build they came from.
resorts.geojsonA FeatureCollection: each resort's mapped operating area, or its point when only a point is mapped.
resorts.datapackage.jsonA Frictionless data package 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.

curl 'https://opensnotel.com/api/v1/datasets/resorts.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:

curl 'https://opensnotel.com/api/v1/datasets/resorts.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.