Resorts

List all ski resorts

Returns ski resorts with current conditions and SnowSure scores. Use for: browse or filter by region/country; best resorts in Europe, Asia, or North America; sort by score, snowfall, or forecast. Example: ?region=asia&sort=score&limit=20

Forecast entitlement (SS-W-318). Days 1–7 and the blended total are public. Days 8–14 and the per-model series (models, byModel, comparableWindow, modelCoverageDays) require an entitled caller: SnowSure Pro, or a signed-in free reader asking about a resort in their My Mountains. An unauthenticated request receives the free window — forecast.daily cut to seven days, total14dCm equal to the total of those days, and forecastHorizonDays: 7 stating the span. The field keeps its name so existing consumers keep reading a number; read forecastHorizonDays to know what it covers. There is no partner key: every caller follows the same rule.

get/api/v1/resorts

Request

  • Base URL: https://www.snowsure.ai
  • URL: https://www.snowsure.ai/api/v1/resorts
  • Auth: none declared

Query parameters

limitinteger

Maximum number of results to return (default: 100, max: 1000)

region'europe' | 'north-america' | 'asia' | 'oceania' | 'south-america'

Filter by region

countrystring

Filter by country name

sort'score' | 'snowfall' | 'forecast' | 'name'

Sort order. forecast ranks on the total each row publishes as conditions.forecast14dCm, over the span forecastHorizonDays states (seven days unless the caller is entitled to more); resorts with no forecast rank last.

slugsstring

Comma-separated list of resort slugs to fetch specific resorts

cursorstring

Opaque pagination cursor from a previous response's top-level nextCursor. When cursor or limit is supplied, the response includes nextCursor (null on the last page). Omit both for the default (first-page) response.

includestring
Example:dailyForecast

Comma-separated extras. dailyForecast adds dailyForecast to every row: SnowSure's blended daily snowfall from the resort-local today (at most 14 days with Pro, seven without — the same per-day values as forecast.daily[].snowfall on /api/v1/resorts/{slug}) and next48hCm. Served from one bulk read per cache window for the whole catalogue, so ?include=dailyForecast (with cursor or slugs) replaces a per-resort detail read. Unknown values are ignored.

Response

Successful response

nextCursorstring nullable

Opaque cursor for the next page; null when no further pages. Only present when the request used the cursor or limit query parameter.

Example response

{
  "meta": {
    "source": "SnowSure",
    "total": 556,
    "count": 100
  },
  "data": [
    {
      "name": "Niseko Hanazono Resort",
      "slug": "niseko-hanazono-resort",
      "aliases": [
        "arlberg",
        "saint-anton",
        "sankt-anton",
        "st-anton",
        "st-anton-am-arlberg"
      ],
      "country": "Japan",
      "region": "asia",
      "snowSure": {
        "ratingColor": "#22c55e"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.