<< Back to Docs Index

GET /snow-report/:id_or_slug v1

GET (Version 1)

Retrieve the most recent snow report.

Return the most recent resort reported snowfall, base depth, operating status, and conditions.

Example Requests

Retrieve snow report for Aspen Highlands.

curl -X GET https://api.opensnow.com/snow-report/aspenhighlands?v=1&api_key=XYZ123

❄️ Schema ❄️

Route Params

/snow-report/:id_or_slug

Route Params Schema

Name Type Description
id_or_slug
 string A location id (integer) or a location slug (string). Email [email protected] with any questions about how to find your location id or slug.
Examples: 1,2,"alta","steamboat","aspenhighlands"
   Pattern: ^[0-9a-zA-Z-]+$

Query String Parameters

Query String Parameters Sample

{
  "units": "imperial",
  "v": 1,
  "api_key": "string"
}

Query String Parameters Schema

Name Type Description
units
 string Units to return data values in.
Default: imperial   Enum: imperial,metric
v
 integer
Required		 Integer version number == 1
api_key
 string
Required		 API Access Token

Response 200

Response 200 Sample

{
  "id": 1,
  "slug": "blue-sky-basin-summit",
  "name": "Blue Sky Basin Summit",
  "coordinates": {
    "point": [
      -105.2705,
      40.015
    ]
  },
  "elevation": 0,
  "timezone": "America/Denver",
  "snow_report": {
    "display_at": "2019-08-24T14:15:22Z",
    "display_at_local_label": "Thu Mar 23 5:45 AM MDT",
    "status_id": "0",
    "status_display": "Not Available",
    "status_display_detail": "Re-open 12/20",
    "status_notes": "After an incredible week with over two feet of new snow, the sunshine and warm temps are back! Our base is now up to 61\" and the packed powder is soft both on and off-piste. Enjoy your Saturday carving up the fresh groomers or searching for powder stashes!",
    "status_notes_html": "After an incredible week with over <b>TWO FEET</b> of new snow, the sunshine and warm temps are back! Our base is now up to 61\" and the packed powder is soft both on and off-piste. Enjoy your Saturday carving up the fresh groomers or searching for powder stashes!",
    "conditions": "Packed Powder",
    "lifts_open": 8,
    "lifts_total": 10,
    "runs_open": 42,
    "runs_total": 42,
    "area_open": 2500,
    "area_total": 3000,
    "percent_open": 0.42,
    "precip_snow_24h": 6,
    "precip_snow_5d": 22,
    "precip_snow_season": 181,
    "base_depth": 42,
    "base_depth_min": 42,
    "base_depth_max": 42
  },
  "attribution": {
    "link_url": "http://example.com",
    "link_text": "string",
    "description": "string",
    "image_light_url": "http://example.com",
    "image_dark_url": "http://example.com"
  }
}

Response 200 Schema

Name Type Description
id
 integer Location integer id primary key, -9999 is reserved for a user specific unsaved custom location. Other negative numbers are not real locations but may be returned.
Examples: 1,100,-9999
slug
 string Location slug, for use in urls. These are guaranteed to be unique across all locations.
Examples: blue-sky-basin-summit,vail-ski-resort,vail-ski-resort-summit
name
 string Location name
Examples: Blue Sky Basin Summit,Vail Ski Resort,Vail Ski Resort (Summit)
coordinates
 object
coordinates.
  point
 array Point coordinates, WGS84 lng, lat. Rounded to 4pts of precision, roughly 30 feet, 11 meters.
Example: -105.2705,40.015
coordinates.
  point[0]
 number Longitude
Min: -180   Max: 180
coordinates.
  point[1]
 number Latitude
Min: -90   Max: 90
elevation
 integer Elevation of the forecasted point. Units in feet if imperial, meters if metric.
timezone
 string
Required		 IANA timezone name
Examples: America/Denver,America/Los_Angeles,Asia/Hong_Kong
snow_report
 object
nullable		 A snow report for a resort, as reported by the humans at the resort.
snow_report.
  display_at
 date-time string
Required		 Display time for the resort report, in UTC. Convert to local time using location IANA timezone name.
snow_report.
  display_at_local_label
 string User displayable local timezone date/time label. Opinionated, style varies as appropriate.
Example: Thu Mar 23 5:45 AM MDT
snow_report.
  status_id
 integer The status id for the resorts operating status.
Enum: 0,1,2,3,4
snow_report.
  status_display
 string The displayable status string.
Examples: Not Available,Open,Temporarily Closed,Closed,Summer Operations
snow_report.
  status_display_detail
 string
nullable		 Detailed operating status. Only populated if status is opening soon.
Example: Re-open 12/20
snow_report.
  status_notes
 string
nullable		 Longer form operating details. Only populated if resort is open.
Example: After an incredible week with over two feet of new snow, the sunshine and warm temps are back! Our base is now up to 61" and the packed powder is soft both on and off-piste. Enjoy your Saturday carving up the fresh groomers or searching for powder stashes!
snow_report.
  status_notes_html
 string
nullable		 Longer form operating details that may include a subset of HTML tags (a, p, b, i, em, strong). Populated in all resort statuses.
Example: After an incredible week with over <b>TWO FEET</b> of new snow, the sunshine and warm temps are back! Our base is now up to 61" and the packed powder is soft both on and off-piste. Enjoy your Saturday carving up the fresh groomers or searching for powder stashes!
snow_report.
  conditions
 string
nullable		 Snow surface conditions as reported by resort.
Examples: Packed Powder,Machine Groomed
snow_report.
  lifts_open
 integer
nullable		 Number of lifts open at the resort.
Example: 8
snow_report.
  lifts_total
 integer
nullable		 Total number of lifts at the resort.
Example: 10
snow_report.
  runs_open
 integer
nullable		 Number of runs open at the resort.
Example: 42
snow_report.
  runs_total
 integer
nullable		 Total number of lifts at the resort.
Example: 42
snow_report.
  area_open
 integer
nullable		 Skiable area open at the resort. (metric: hectares, imperial: acres)
Example: 2500
snow_report.
  area_total
 integer
nullable		 Total skiable area at the resort. (metric: hectares, imperial: acres)
Example: 3000
snow_report.
  percent_open
 number
nullable		 Percentage of open terrain (runs_open / runs_total)
Example: 0.42
snow_report.
  precip_snow_24h
 integer
nullable		 The amount of new snow in the last 24 hours. (metric: cm, imperial: in)
Example: 6
snow_report.
  precip_snow_5d
 integer
nullable		 The amount of new snow in the last 5 days. (metric: cm, imperial: in)
Example: 22
snow_report.
  precip_snow_season
 integer
nullable		 The amount of new snow over the entire season. (metric: cm, imperial: in)
Example: 181
snow_report.
  base_depth
 integer
nullable		 The current base depth at the resort. (metric: cm, imperial: in)
Example: 42
snow_report.
  base_depth_min
 integer
nullable		 In cases where resorts report base depth ranges, the low end of the range. (metric: cm, imperial: in)
Example: 42
snow_report.
  base_depth_max
 integer
nullable		 In cases where resorts report base depth ranges, the low high end of the range. (metric: cm, imperial: in)
Example: 42
attribution
 object
Required		 Attribution details for data crediting and links back to source content.
attribution.
  link_url
 uri string
nullable		 URL to additional content on OpenSnow or OpenSummit platform.
attribution.
  link_text
 string
nullable		 Text to display for the additional content link.
attribution.
  description
 string
Required		 Fine print disclaimer for attribution of source content.
attribution.
  image_light_url
 uri string
Required		 URL OpenSnow or OpenSummit logo image, for use in light mode themes.
attribution.
  image_dark_url
 uri string
Required		 URL OpenSnow or OpenSummit logo image, for use in dark mode themes.

Response 4xx

Response 4xx Sample

{
  "status_code": 400,
  "error": "Bad Request",
  "messages": [
    "string"
  ]
}

Response 4xx Schema

Name Type Description
status_code
 integer
Required		 HTTP status code
Min: 400   Max: 499
error
 string
Required		 Error description
Examples: Bad Request,Unauthorized,Forbidden,Not Found
messages
 array
Required		 More detailed error message. This may be less-detailed/sanitized in production environments so as not to reveal any potentially sensitive information.
messages[0]
 string

Response 5xx

Response 5xx Sample

{
  "status_code": 500,
  "error": "Internal Server Error",
  "messages": [
    "string"
  ]
}

Response 5xx Schema

Name Type Description
status_code
 integer
Required		 HTTP status code
Min: 500   Max: 599
error
 string
Required		 Error description
Example: Internal Server Error
messages
 array
Required		 More detailed error message. This may be less-detailed/sanitized in production environments so as not to reveal any potentially sensitive information.
messages[0]
 string