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" }
}
| 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 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
resolvedFromgives the slug you asked for withreasonrenamedormerged. Useidorslugfrom 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
removedAtset. - Elevation and counts are mapped, not official.
elevationand 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.
fieldSourcesnames the source of each canonical field:openskidata,wikidata(it fills a missing website) oroverride, 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 itsrelationshipand arationalein the reviewer's words.representativemeans the station is a good proxy for the resort's snow;same_mountain,secondaryandnearbysay 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 (rank1 is nearest). A candidate'srelationshipis alwaysnearbyand it has norationale. 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.
distanceKmis the great-circle distance from the resort's representative point.elevationDifferenceMis 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.tripletto 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.
| 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 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.csvis always the current file. It is cached for about an hour and sent with the version as itsETag, soIf-None-Matchanswers304until the registry changes.GET /api/v1/datasets/resorts.csv?version=791ee6c223da120fis 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
404withnot_found, anddetails.currentVersionnames the version to use.