---
title: "Season leaderboard by geography"
method: GET
path: "/api/v1/leaderboards/season"
tags: ["ML/AI Trends"]
---

# Season leaderboard by geography

`GET /api/v1/leaderboards/season`

## Request

- Base URL: `https://www.snowsure.ai`
- URL: `https://www.snowsure.ai/api/v1/leaderboards/season`
- Auth: none required

Resorts ranked on a season metric, for any tracked season, scoped by country, state/province or region. Figures come from ERA5 reanalysis across the whole season window, so they cover the full season rather than only the days SnowSure was live.

**Auth:** none.

**Caching:** `Cache-Control: public, s-maxage=300, stale-while-revalidate=600` (Vercel CDN, 5 minutes).

## Query parameters

- `metric` 'snow_days' | 'total_cm' | 'powder_days' | 'bluebird_days' | 'max_storm' | 'peak_depth' | 'longest_dry_spell'
- `season` string
- `hemisphere` 'nh' | 'sh'
- `country` string
- `state` string
- `region` string
- `limit` integer
- `ascending` boolean

## Response `200`

Season leaders

- SeasonLeaderboardResponse
  - `generatedAt` string, date-time, required
  - `metric` 'snow_days' | 'total_cm' | 'powder_days' | 'bluebird_days' | 'max_storm' | 'peak_depth' | 'longest_dry_spell', required
  - `metricLabel` string, required
  - `season` object, required
    - `year` integer
    - `hemisphere` 'NH' | 'SH'
    - `label` string
    - `startDate` string, date, nullable
    - `endDate` string, date, nullable
  - `scope` object, required
    - `country` string
    - `region` string
    - `stateProvince` string
  - `source` string, required
  - `leaders` object[], required
    - `rank` integer
    - `slug` string
    - `name` string
    - `country` string, nullable
    - `stateProvince` string, nullable
    - `region` string, nullable
    - `value` number, nullable: The ranked metric, in `unit`.
    - `unit` 'cm' | 'days'
    - `snowDays` number, nullable
    - `totalCm` number, nullable
    - `powderDays` number, nullable
    - `maxStormCm` number, nullable
    - `maxStormDate` string, date, nullable
  - `note` string: Present when nothing matched the scope.
  - `hint` string: Present when `metric` was not recognised; lists the supported metrics.

---

[API](https://skmtc.dev/snowsure/apis/snowsure-api.md) · [All operations](https://skmtc.dev/snowsure/apis/snowsure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snowsure/apis/snowsure-api/revisions/dcbcdbb3df50?raw)