OnTheSnow.com Web Service Documentation

The SnowReport Web Service offered by OnTheSnow.com/SkiInfo.com allows media organizations to add real time snow reports and resort information for ski resorts throughout the world.

A sample feed can be found here - Sample

Supported Interfaces
Authentication
Language and Metrics
Credit Line and Attribution
Weather Icons
FAQ
Request Methods Index
Response Objects Index

Supported Interfaces

REST

Our REST services support both XML and JSON responses.

WDSL 2.0: http://services.onthesnow.com/axis2/services/SnowReport2009.wsdl

The REST urls are located in the WSDL SnowReport2009HttpBinding

ContentType Add to URL
application/xml DEFAULT response
application/json response=json

We are currently in the process of building out tools to help in the parsing and accessing of our web services.

WebService Tools

SOAP

Our SOAP services support both SOAP 1 and SOAP 2 bindings

WDSL 1.1: http://services.onthesnow.com/axis2/services/SnowReport2009SOAP.wsdl

Axis2 is the current platform we are running our webservice on. We use Document/Literal encoding.

The SOAP service is for advanced users. The document below is geared towards RESTful users, however the fields and objects returned are identical for each service.

The WSDL is the document for the SOAP service. This should be used to build your applications.

We use SOAPSonar Personal (SOAP client GUI) to validate and test our service, from CrossCheck Networks. You can learn about their Free Personal version at CrossCheck Networks

Authentication

Authentication is handled soley in the URL of the request. NO STATE information is preserved by there service.

Getting my Tokens

When you sign up for the webservice you will receive and email and a password. You can get your tokens by using the tokens request by using the URL below.

http://services.onthesnow.com/axis2/services/SnowReport2009/tokens/YOUREMAIL/YOURPASSWORD

You will receive back a list of Tokens.

Authentication Parameters

email The email that your registered the service with.
password The password your registered the service with.
met The metric (Imperial or metric) which you want the data to be returned in.
values: [imp|met]
lang The language you want the service to be returned in. See the wsdl for the enumerations of the language.

Authentication Errors

Check your password and username

Check your token/domain to make sure they are correct.

Languages And Metrics

Defaults:: English (www.onthesnow.com), Imperial.

The default language for the service is English with imperial units.

The language and metric can be changed by using the parameters

lang - Set the language for the service calls.
met - Set the metric for the service calls. [ imp | met]

Note: You must include both language and metric in your query string to override the default language. You need to check the signature of the method to ensure you have the correct ordering.

We currently support the following lanugages:

langLanguageMetricSite
frfrmethttp://www.skiinfo.fr
fr-befrmethttp://fr.skiinfo.be
fr-chfrmethttp://fr.skiinfo.ch
es-doeslamethttp://www.onthesnow.com.mx
es-coeslamethttp://www.onthesnow.com.mx
nonomethttp://www.skiinfo.no
es-cleslamethttp://www.onthesnow.com.mx
fr-cafr-camethttp://fr.onthesnow.ca
es-nieslamethttp://www.onthesnow.com.mx
es-gteslamethttp://www.onthesnow.com.mx
es-veeslamethttp://www.onthesnow.com.mx
en-caen-camethttp://www.onthesnow.ca
en-ieenmethttp://www.onthesnow.com
en-gben-gbmethttp://www.onthesnow.co.uk
es-areslamethttp://www.onthesnow.com.mx
en-usenimphttp://www.onthesnow.com
en-ttenmethttp://www.onthesnow.com
enenimphttp://www.onthesnow.com
es-hneslamethttp://www.onthesnow.com.mx
es-esesesmethttp://www.skiinfo.es
dedemethttp://www.skiinfo.de
de-dedemethttp://www.skiinfo.de
de-chdemethttp://de.skiinfo.ch
es-preslamethttp://www.onthesnow.com.mx
es-sveslamethttp://www.onthesnow.com.mx
es-boeslamethttp://www.onthesnow.com.mx
en-zaenmethttp://www.onthesnow.com
es-peeslamethttp://www.onthesnow.com.mx
es-creslamethttp://www.onthesnow.com.mx
es-pyeslamethttp://www.onthesnow.com.mx
svsvmethttp://www.skiinfo.se
es-mxeslamethttp://www.onthesnow.com.mx
es-uyeslamethttp://www.onthesnow.com.mx
ititmethttp://www.skiinfo.it/
it-chitmethttp://it.skiinfo.ch/
en-auen-aumethttp://www.onthesnow.com.au
en-nzen-nzmethttp://www.onthesnow.co.nz
de-atdemethttp://at.skiinfo.com
es-paeslamethttp://www.onthesnow.com.mx
es-eceslamethttp://www.onthesnow.com.mx
nlnlmethttp://www.skiinfo.nl
nl-benlmethttp://nl.skiinfo.be
rurumethttp://www.onthesnow.ru
ptptmethttp://www.onthesnow.pt
plplmethttp://www.skiinfo.pl
dadamethttp://www.skiinfo.dk
cscsmethttp://www.onthesnow.cz
skskmethttp://www.onthesnow.sk

Credit Lines

Credit line and attribution links on any application, page, screen or window presentation of the data.

Global Attribution information is available via the getSiteAttribution method.

Resort Attribution information is avalable via the getResortAttribution method.

Weather Icons

The following weather icons are used for the Forecast and Weather objects.

Note: nt_ denotes nighttime icon

ICONDescription
chanceflurriesChance of Flurries
chancerainChance of Rain
chancesleatChance of Sleet
chancesnowChance of Snow
chancetstormsChance of a Thunderstorm
clearClear
cloudyCloudy
flurriesFlurries
hazyHazy
mostlycloudyMostly Cloudy
mostlysunnyMostly Sunny
nt_chanceflurriesChance of Flurries
nt_chancerainChance of Rain
nt_chancesleatChance of Sleet
nt_chancesnowChance of Snow
nt_chancetstormsChance of a Thunderstorm
nt_clearClear
nt_cloudyCloudy
nt_flurriesFlurries
nt_hazyHazy
nt_mostlycloudyMostly Cloudy
nt_mostlysunnyPartly Cloudy
nt_rainRain
nt_sleatSleet
nt_snowSnow
nt_sunnyClear
nt_tstormsThunderstorm
nt_unknownUnknown
partlycloudyPartly Cloudy
partlysunnyPartly Sunny
rainRain
sleatSleet
snowSnow
sunnySunny
tstormsThunderstorm
unknownUnknown

FAQ

How do I get a list of all the resorts.

  1. getRegions returns a list Region objects.
  2. For each Region you can get the State object.
  3. Foreach State.abbrev you can call getRegionResortsLastUpdated which will return a ResortUpdateRecord that contains the resort names and ids within that region.
  4. .

How should I do batch updates to my systems.

If you are going to batch all resort data and run it from your own data store you need to be efficient with how you call your methods. Otherwise you may exceed your monthly request limit.

Using the Regions

Use the getRegion methods to batch many resorts at once.

Use the resorts

Use the getRegionResortsLastUpdated method for each Region.State.abbrev to find when the last updates for Snow (snow_updated) and Information (profile_updated) occurred. If the snow_updated or profile_updated is greater than your time stamp then pull down the updated record for the resort. Otherwise skip that record.

Request Methods Index

Response Objects Index

Request Methods

getRegion

Gets a Region object which contain all the State/Provinces listed by OTS for that region. The method can be used to retrieve the list of state names and state abbrev to pull down information for the region specific servcies.

Request Requires a region_id.
Response The getRegion request will return a list of Region element.
Response Object Region
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in region_id #in lang #in met #in return #return
Address region/states/{region_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/region/states/10/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getRegion Response

getRegionCams

Gets a list of snow cams for a state.

NOTE:Requires access to the OTS Cams service

Request Requires a state_abbrev and optional resort_id[].
Response Returns upto 5 cams per resort.
Response Object Cam[]
Optional Parameters ?resort_id=[resort_id]&lang=[lang]&met=>[met]
Signature token #in domain #in state_abbrev #in resort_id #in lang #in met #in return #return
Address state/cams/{state_abbrev}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/state/cams/CN/DOMAIN/TOKEN?&resort_id=5&resort_id=419&resort_id=21&lang=en&met=imp&&
XML Response Sample getRegionCams Response

getRegionDeals

Get a list of Deal objects which contain deals.

NOTE:Available to all subscribers to the service.

Request Requires a state_abbrev element to pull down the list of resort in the state.
Response Receives a list of Deal objects.
Response Object Deal
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in state_abbrev #in lang #in met #in cat #in return #return
Address state/deals/{state_abbrev}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/state/deals/CN/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getRegionDeals Response

getRegionNews

Get a list of Story objects which contain news stories.

NOTE:Available to all subscribers to the service.

Request Requires a state_abbrev element to pull down the list of resort in the state.
Response Receives a list of Story.
Response Object Story
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in state_abbrev #in lang #in met #in cat #in return #return
Address state/news/{state_abbrev}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/state/news/CN/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getRegionNews Response

getRegionPhotos

Gets a list of photos for a state. .

NOTE:Requires access to the OTS Cams service

Request Requires a state_abbrev and optional resort_id[].
Response List of Photo objects
Response Object Photo[]
Optional Parameters ?resort_id=[resort_id]&lang=[lang]&met=>[met]
Signature token #in domain #in state_abbrev #in resort_id #in lang #in met #in return #return
Address state/photos/{state_abbrev}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/state/photos/CN/DOMAIN/TOKEN?&resort_id=5&resort_id=419&resort_id=21&lang=en&met=imp&&
XML Response Sample getRegionPhotos Response

getRegionResortsLastUpdated

Get a list of ResortUpdateRecord objects which tells when the last time a resort's info and snowreport was updated.

NOTE:Available to all subscribers to the service.

Request Requires a state_abbrev element to pull down the list of resort in the state.
Response Receives a list of ResortUpdateRecord.
Response Object ResortUpdateRecord
Optional Parameters ?lang=[lang]&met=>[met]&[ resort_id=[] ...]
Signature token #in domain #in state_abbrev #in lang #in met #in resort_id #in return #return
Address region/{state_abbrev}/resorts/lastupdate/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/region/CN/resorts/lastupdate/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getRegionResortsLastUpdated Response

getRegionSnowReportMobile

Get a more detailed SnowReport for resorts in a State/Region.

NOTE:Requires access to the Mobile services

Request The method has an optional list of resort_id parameters, which limits the response to only resorts in the list.
Response Returns a list ResortSnowReportMobile objects.
Response Object ResortSnowReportMobile[]
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in state_abbrev #in lang #in met #in resort_id #in return #return
Address mobile/region/resorts/snow/{state_abbrev}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/mobile/region/resorts/snow/CN/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getRegionSnowReportMobile Response

getRegionSnowReportMobilePlus

Get the most detailed SnowReport for resorts in a State/Region.

NOTE:Requires access to the MobilePlus services

Request The method has an optional list of resort_id parameters, which limits the response to only resorts in the list.
Response Returns a list ResortSnowReportMobilePlus objects.
Response Object ResortSnowReportMobilePlus[]
Optional Parameters ?lang=[lang]&met=>[met]&resort_id
Signature token #in domain #in state_abbrev #in lang #in met #in resort_id #in return #return
Address plus/region/resorts/snow/{state_abbrev}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/plus/region/resorts/snow/CN/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getRegionSnowReportMobilePlus Response

getRegionSnowReportWeb

Request
Response
Response Object
Optional Parameters
Signature token #in domain #in state_abbrev #in lang #in met #in resort_id #in return #return
Address web/region/resorts/snow/{state_abbrev}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/web/region/resorts/snow/CN/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getRegionSnowReportWeb Response

getRegions

Gets a list of Region elements which contain all the State/Provinces listed by OTS. The method can be used to retrieve the list of state names and state abbrev to pull down information for the region specific servcies.

Request
Response The getRegions request will return a list of Region elements.
Response Object
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in lang #in met #in return #return
Address regions/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/regions/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getRegions Response

getResortAttribution

Gets the credit line data for resortd in SnowReport service.

Request Requires a resort_id.
Response Returns an ResortAttribution object.
Response Object ResortAttribution
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address resort/attribution/{resort_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/resort/attribution/330/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getResortAttribution Response

getResortCams

Gets a list of snow cams for a given resort.

NOTE:Requires access to the OTS Cams service.

Request Requires a resort_id parameter.
Response Returns a maximum of 5 Cam Objects.
Response Object Cam[]
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address resort/cams/{resort_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/resort/cams/330/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getResortCams Response

getResortDeals

Get a list of Deal objects which contain deals.

NOTE:Available to all subscribers to the service.

Request Requires a resort_id element.
Response Receives a list of Deal objects.
Response Object Deal
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in cat #in return #return
Address resort/deal/{resort_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/resort/deal/330/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getResortDeals Response

getResortInfoLite

Gets a minimal view of the resorts information.

NOTE:Available to all subscribers to the service.

Request
Response Returns a ResortInfoLite object
Response Object ResortInfoLite
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address lite/resort/info/{resort_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/lite/resort/info/330/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getResortInfoLite Response

getResortInfoMobile

Gets a more detailed view of the resort's information.

NOTE:Requires access to the Mobile services

Request The method requires a resort element with value of resort_id.
Response Returns a ResortInfoMobile object.
Response Object ResortInfoMobile
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address mobile/resort/info/{resort_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/mobile/resort/info/330/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getResortInfoMobile Response

getResortInfoMobilePlus

Gets the most detailed view of a resort's information.

NOTE:Requires access to the MobilePlus services.

Request The method requires a resort element with value of resort_id.
Response Returns a ResortInfoMobilePlus object.
Response Object ResortInfoMobilePlus
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address plus/resort/info/{resort_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/plus/resort/info/330/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getResortInfoMobilePlus Response

getResortInfoWeb

Gets a detailed view of the resorts information

NOTE:Requires access to the "Web" services.

Request Requires a resort_id.
Response Returns a ResortInfoWeb object
Response Object ResortInfoWeb
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address web/resort/info/{resort_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/web/resort/info/330/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getResortInfoWeb Response

getResortInformation

Request
Response
Response Object
Optional Parameters
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address getResortInformation
Example URI
XML Response Sample getResortInformation Response

getResortNews

Get a list of Story objects which contain news stories.

NOTE:Available to all subscribers to the service.

Request Requires a resort_id element.
Response Receives a list of Story objects.
Response Object Story
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in cat #in return #return
Address resort/news/{resort_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/resort/news/330/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getResortNews Response

getResortPhotos

Gets a list of resort provided photos for a given resort.

NOTE:Requires access to the OTS Cams service.

Request Requires a resort_id parameter.
Response Returns a maximum of 5 Photo Objects.
Response Object Photo[]
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address resort/photos/{resort_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/resort/photos/120/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getResortPhotos Response

getResortSnowReportLite

Get a minimal SnowReport for a resort.

NOTE:Available to all subscribers to the service.

Request The method requires a resort element with value of resort_id.
Response Returns a ResortSnowReportLite object.
Response Object ResortSnowReportLite
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address lite/resort/snow/{resort_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/lite/resort/snow/330/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getResortSnowReportLite Response

getResortSnowReportMobile

Get a more detailed SnowReport for a resort. Includes weather, a cam, and all our snowreporting data points.

NOTE:Requires access to the Mobile services

Request The method requires a resort element with value of resort_id.
Response Returns a ResortSnowReportMobile object.
Response Object ResortSnowReportMobile
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address mobile/resort/snow/{resort_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/mobile/resort/snow/330/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getResortSnowReportMobile Response

getResortSnowReportMobilePlus

Get the most detailed SnowReport for a resort. Includes weather, forecasts, a cam and all our snowreporting data points.

NOTE:Requires access to the MobilePlus services

Request The method requires a resort element with value of resort_id.
Response Returns a ResortSnowReportMobilePlus object.
Response Object ResortSnowReportMobilePlus
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address plus/resort/snow/{resort_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/plus/resort/snow/330/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getResortSnowReportMobilePlus Response

getResortSnowReportWeb

Get the most detailed SnowReport for a resort Can be bundled with Weather and Cams.

NOTE:Requires access to the "Web" services

Request The method requires a resort element with value of resort_id.
Response Returns a ResortSnowReportWeb object.
Response Object ResortSnowReportWeb
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address web/resort/snow/{resort_id}/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/web/resort/snow/330/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getResortSnowReportWeb Response

getResortsSnowReportLite

Get a minimal SnowReport for a resort.

NOTE:Available to all subscribers to the service.

Request The method requires a list of resort_id parameters.
Response Returns a list of ResortSnowReportLite objects.
Response Object ResortSnowReportLite[]
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address lite/resorts/snow/{domain}/{token}
Example URI
XML Response Sample getResortsSnowReportLite Response

getResortsSnowReportMobile

Get a more detailed SnowReport for a resort. Includes weather, a cam, and all our snowreporting data points.

NOTE:Requires access to the Mobile services

Request The method requires a list of resort_id parameters.
Response Returns a list ResortSnowReportMobile objects.
Response Object ResortSnowReportMobile[]
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address mobile/resorts/snow/{domain}/{token}
Example URI
XML Response Sample getResortsSnowReportMobile Response

getResortsSnowReportMobilePlus

Get the most detailed SnowReport. Includes weather, forecasts, a cam and all our snowreporting data points. This method is for creating a custom feed. You can mix and match resort ids from any region for up to 50 resorts.

NOTE:Requires access to the MobilePlus services

Request The method requires a list of resort_id parameters.
Response Returns a list ResortSnowReportMobilePlus objects.
Response Object ResortSnowReportMobilePlus[]
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address plus/resorts/snow/{domain}/{token}
Example URI
XML Response Sample getResortsSnowReportMobilePlus Response

getResortsSnowReportWeb

Get the most detailed SnowReport. Can be bundled with weather, forecasts, and cam. This method is for creating a custom feed. You can mix and match resort ids from any region for up to 50 resorts.

NOTE:Requires access to the "Web" services

Request The method requires a list of resort_id parameters.
?resort_id=&resort_id=
Response Returns a list ResortSnowReportWeb objects.
Response Object ResortSnowReportWeb[]
Optional Parameters &lang=[lang]&met=>[met]
Signature token #in domain #in resort_id #in lang #in met #in return #return
Address web/resorts/snow/{domain}/{token}
Example URI
XML Response Sample getResortsSnowReportWeb Response

getSiteAttribution

Gets the credit line data for the SnowReport service.

Request
Response Returns an Attribution object.
Response Object Attribution
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in lang #in met #in return #return
Address attribution/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/attribution/DOMAIN/TOKEN?lang=en&met=imp&&
XML Response Sample getSiteAttribution Response

getTokens

Gets all the tokens and domain keys any web sites registered under your account. The tokens/domain keys are used authenticate with the SnowReport.

NOTE:The token/domain combination is the only way to authenticate with our V2009 web service. Email and password are no longer used.

Request
Response You will receive a token response containing an array of Tokens with domain and token as elements
Response Object
Optional Parameters ?lang=[lang]&met=>[met]
Signature email #in password #in language #in return #return
Address tokens/{email}/{password}
Example URI
XML Response Sample getTokens Response

searchResortsByGeocode

Searches for resorts by distance from a provided latitude and longitude. The distance is either in miles or km as determined by met.

NOTE:Max return is 50 resorts.

Request Requires a lat and lon [double,float,decimal], distance integer < 500, and string and a get_n to limit results to n.
Response Returns a list of ResortSearch objects. Distance is rounded to nearest KM/MI. Orderd by distance ASC
Response Object ResortSearch[]
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in lat #in lon #in distance #in get_n #in lang #in met #in return #return
Address find/resorts/geo/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/find/resorts/geo/DOMAIN/TOKEN?lang=en&met=imp&&lat=38.00&lon=-121.00&get_n=10&distance=200
XML Response Sample searchResortsByGeocode Response

searchResortsByName

Searches for resorts by name, matchining search string as %search%. Orders by name.

NOTE:Max return is 50 resorts.

Request Requires a search string and a get_n to limit results to n.
Response Returns a list of ResortSearch objects.
Response Object ResortSearch[]
Optional Parameters ?lang=[lang]&met=>[met]
Signature token #in domain #in search #in get_n #in lang #in met #in return #return
Address find/resorts/name/{domain}/{token}
Example URI http://services.onthesnow.com/axis2/services/SnowReport2009/find/resorts/name/DOMAIN/TOKEN?lang=en&met=imp&&search=mammoth&get_n=10
XML Response Sample searchResortsByName Response

template

Request
Response
Response Object
Optional Parameters ?lang=[lang]&met=>[met]
Signature
Address
Example URI
XML Response Sample template Response

Response Object

Attribution

Objects | Methods | _top
@type
credit_line String The global site credit line..
image Int The onthesnow image to use for the credit line.
url URL The URL to use for credit line.

Cam

Objects | Methods | _top
@type
caption Int The photo's caption. Note: Non-English users will have the resort_name used for the caption.
date_modified Int The date the photo was last modified.
height Int The height of the photo.
resort_id
resort_name Int The resort_name for the Cam element.
url URL The location fo the image.
width Int The width of the photo.

Deal

Objects | Methods | _top
@type
description
id Int the news id .
link URL the link to the full story.
pubdate Date the published date.
title Int the title.

Forecast

Objects | Methods | _top
@type
conditions String forecasted weather condition
date_epoch Int forecast date epoch format
date_long String forecast date long format
icon String forecasted weather icon
pop Int ?
skyicon String ski conditions icon
snow_fall_daytime_cm Int projected snow fall daytime (cm)
snow_fall_daytime_in Int projected snow fall daytime (inches)
snow_fall_total Int projected snow fall total (inches)
snow_fall_total_cm Int projected snow fall total (cm)
temp_high_c Int projected high temperature (c)
temp_high_f Int projected high temperature (f)
temp_low_c Int projected low temperature (c)
temp_low_f Int projected low temperature (f)

Photo

Objects | Methods | _top
@type
caption Int The photo's caption. Note: Non-English users will have the resort_name used for the caption.
date_modified Int The date the photo was last modified.
height Int The height of the photo.
resort_id
resort_name Int The resort_name for the Cam element.
url URL The location fo the image.
width Int The width of the photo.

Region

Objects | Methods | _top
@type
id Int the region id .
name String Region name.
states State a list of State objects.

ResortAttribution

Objects | Methods | _top
@type
cams String The cams URL.
cams_text String The text to use for cams credit line.
credit_line String The global site credit line..
image Int The onthesnow image to use for the credit line.
lifttickets String The lifttickets URL.
lifttickets_text String The text to use for lifttickets credit line.
news String The news URL.
news_text String The text to use for news credit line.
profile String The URL to use for profile credit line.
profile_text String The text to use for profile credit line.
resort_id
skireport URL The skireport URL.
skireport_text String The text to use for skireport credit line.
trailmap String The trailmap URL.
trailmap_text String The text to use for trailmap credit line.
travel URL The travel URL.
travel_text String The text to use for travel credit line.
url URL The URL to use for credit line.
weather String The weather URL.
weather_text String The text to use for weather credit line.

ResortInfoLite

Objects | Methods | _top
@type
elevation_base Integer (meters or feet) Base elevation
elevation_top Integer (meters or feet) Top elevation
gallery URL Optional Link to the resort gallery.
id integer the resort_id for the resort.
latitude Double Optional Latitude
longitude Double Optional Longitude
mailing_address String Address
mailing_city String City
name String Resort's name.
name_long String Resort's long name.
number_runs Integer Number of runs.
projected_closing Integer Projected Closing day.
projected_opening Integer Projected Opening day
state_abbrev String State Abbreviation
state_name String State Name
zip String Postal code

ResortInfoMobile

Objects | Methods | _top
@type
elevation_base Integer (meters or feet) Base elevation
elevation_top Integer (meters or feet) Top elevation
gallery URL Optional Link to the resort gallery.
id integer the resort_id for the resort.
latitude Double Optional Latitude
longitude Double Optional Longitude
mailing_address String Address
mailing_city String City
name String Resort's name.
name_long String Resort's long name.
num_quad_chair Integer Number of quad chair lifts.
number_runs Integer Number of runs.
projected_closing Integer Projected Closing day.
projected_opening Integer Projected Opening day
state_abbrev String State Abbreviation
state_name String State Name
tubing_total_lanes Integer Number of Tubing lanes.
zip String Postal code

ResortInfoMobilePlus

Objects | Methods | _top
@type
average_snowfall Integer (cm or inches) Average Snowfall
elevation_base Integer (meters or feet) Base elevation
elevation_top Integer (meters or feet) Top elevation
gallery URL Optional Link to the resort gallery.
id integer the resort_id for the resort.
latitude Double Optional Latitude
lodging_phone String Loding Phone
longest_run Integer (miles or km) Longest Run
longitude Double Optional Longitude
mailing_address String Address
mailing_city String City
name String Resort's name.
name_long String Resort's long name.
num_days_open_last_year Integer # of days open last year
num_double_chair Integer Number of double chair lifts.
num_gondolas_trans Integer Number of gondolas.
num_high_speed_quads Integer Number of high speed quad chair lifts.
num_high_speed_six Integer Number of high speed six lifts.
num_quad_chair Integer Number of quad chair lifts.
num_skiable_acres Integer (acre or hectare) Number of skiable acres.
num_surface_lifts Integer Number of surface lifts
num_triple_chair Integer Number of triple chair lifts.
number_runs Integer Number of runs.
per_advanced_run Integer Percent of runs for advanced.
per_beginner_run Integer Percent of runs for beginner.
per_expert_run Integer Percent of runs for expert.
per_intermediate_run Integer Percent of runs for intermediate.
phone800 String Phone Number
projected_closing Integer Projected Closing day.
projected_dates_open Integer Projected number of open days.
projected_opening Integer Projected Opening day
recreation_profile String Recreation Profile.
resort_profile String Resort Profile.
state_abbrev String State Abbreviation
state_name String State Name
tubing_total_lanes Integer Number of Tubing lanes.
vertical_feet Integer (meters or feet) Vertical distance.
year_opened Integer Year opened
years_open Integer Years open
zip String Postal code

ResortInfoWeb

Objects | Methods | _top
@type
average_snowfall Integer (cm or inches) Average Snowfall
elevation_base Integer (meters or feet) Base elevation
elevation_top Integer (meters or feet) Top elevation
gallery URL Optional Link to the resort gallery.
has_nordic Char [y|n] Has nordic.
has_skiing Char [y|n] Has skiing.
has_terrain_park Char [y|n] Has terrain park.
has_tubing Char [y|n] Has tubing.
id integer the resort_id for the resort.
latitude Double Optional Latitude
lift_capacity Integer
lodging_phone String Loding Phone
longest_run Integer (miles or km) Longest Run
longitude Double Optional Longitude
mailing_address String Address
mailing_city String City
name String Resort's name.
name_long String Resort's long name.
num_days_open_last_year Integer # of days open last year
num_double_chair Integer Number of double chair lifts.
num_gondolas_trans Integer Number of gondolas.
num_high_speed_quads Integer Number of high speed quad chair lifts.
num_high_speed_six Integer Number of high speed six lifts.
num_quad_chair Integer Number of quad chair lifts.
num_skiable_acres Integer (acre or hectare) Number of skiable acres.
num_surface_lifts Integer Number of surface lifts
num_triple_chair Integer Number of triple chair lifts.
number_runs Integer Number of runs.
per_advanced_run Integer Percent of runs for advanced.
per_beginner_run Integer Percent of runs for beginner.
per_expert_run Integer Percent of runs for expert.
per_intermediate_run Integer Percent of runs for intermediate.
phone800 String Phone Number
projected_closing Integer Projected Closing day.
projected_dates_open Integer Projected number of open days.
projected_opening Integer Projected Opening day
recreation_profile String Recreation Profile.
resort_profile String Resort Profile.
skier_email String E-mail
state_abbrev String State Abbreviation
state_name String State Name
tubing_lift_driven Integer [y|n] Tubing is lift driven.
tubing_total_lanes Integer Number of Tubing lanes.
vertical_feet Integer (meters or feet) Vertical distance.
year_opened Integer Year opened
years_open Integer Years open
zip String Postal code

ResortSearch

Objects | Methods | _top
@type
country_name String Country
distance
id integer the resort_id for the resort.
latitude Double Optional Latitude
longitude Double Optional Longitude
name String Resort's name.
physical_address String Address
physical_city String City
state_abbrev String State Abbreviation
state_name String State Name

ResortSnowReportLite

Objects | Methods | _top
@type
base_depth Int inches | cm Snow depth at base.
call_ahead_phone Integer Call Ahead phone
cams URL Optional Link to the resort cams.
has_nordic Char [y|n] Has nordic.
has_skiing Char [y|n] Has skiing.
has_terrain_park Char [y|n] Has terrain park.
has_tubing Char [y|n] Has tubing.
id integer the resort_id for the resort.
lifts_open Int # of lift open out of num_lifts.
lifttickets URL Optional Link to the resort lift tickets.
name String Resort's name.
news URL Optional Link to the resort news.
num_lifts Int Total number of lifts.
number_runs Integer Number of runs.
open_flag String Open | Closed | Temporarily Closed
open_flag_id Int numerical representation of open_flag.
percent_lifts_open Int Percentage of lifts open 0-100.
profile URL Optional Link to the resort profile.
reported_snow_fall Int inches | cm Snow fall in past 24 hours.
reviews URL Optional Link to the resort reviews.
seasonpasses URL Optional Link to the resort season passes page.
skier_email String E-mail
snow_date Date The date and time the snow report was created.
surface_primary String The primary surface conditions.
top_depth Int inches | cm Snow depth at top.
trailmap URL Optional Link to the resort trailmap.
travel URL Optional Link to the resort travel page.
weather URL Optional Link to the resort weather.
website String Empty Resort Website.

ResortSnowReportMobile

Objects | Methods | _top
@type
base_depth Int inches | cm Snow depth at base.
call_ahead_phone Integer Call Ahead phone
cams URL Optional Link to the resort cams.
has_nordic Char [y|n] Has nordic.
has_skiing Char [y|n] Has skiing.
has_terrain_park Char [y|n] Has terrain park.
has_tubing Char [y|n] Has tubing.
id integer the resort_id for the resort.
lifts_open Int # of lift open out of num_lifts.
lifttickets URL Optional Link to the resort lift tickets.
name String Resort's name.
news URL Optional Link to the resort news.
num_lifts Int Total number of lifts.
num_trails_slopes_open Int # of trails/runs open out of number_runs.
number_runs Integer Number of runs.
open_flag String Open | Closed | Temporarily Closed
open_flag_id Int numerical representation of open_flag.
percent_lifts_open Int Percentage of lifts open 0-100.
profile URL Optional Link to the resort profile.
reported_snow_fall Int inches | cm Snow fall in past 24 hours.
reported_snow_fall_48 Int inches | cm Snow fall in past 48 hours.
reported_snow_fall_72 Int inches | cm Snow fall in past 72 hours.
resortWeather Object A resort weather object.
reviews URL Optional Link to the resort reviews.
seasonpasses URL Optional Link to the resort season passes page.
skier_email String E-mail
snow_date Date The date and time the snow report was created.
snow_park_reshaped_dt
snow_pipes_recult_dt Date Only available if has_terrain_park=y KM Skategroomed
surface_primary String The primary surface conditions.
terrain_num_features Integer Only available if has_terrain_park=y Number of Features in terrain park.
top_depth Int inches | cm Snow depth at top.
trailmap URL Optional Link to the resort trailmap.
travel URL Optional Link to the resort travel page.
tubing_lanes_open Intger Only available if has_tubing=y # of tubing lanes that are open.
tubing_lift_driven Integer [y|n] Tubing is lift driven.
weather URL Optional Link to the resort weather.
website String Empty Resort Website.

ResortSnowReportMobilePlus

Objects | Methods | _top
@type
base_depth Int inches | cm Snow depth at base.
call_ahead_phone Integer Call Ahead phone
cams URL Optional Link to the resort cams.
has_nordic Char [y|n] Has nordic.
has_skiing Char [y|n] Has skiing.
has_terrain_park Char [y|n] Has terrain park.
has_tubing Char [y|n] Has tubing.
id integer the resort_id for the resort.
lifts_open Int # of lift open out of num_lifts.
lifttickets URL Optional Link to the resort lift tickets.
name String Resort's name.
news URL Optional Link to the resort news.
num_lifts Int Total number of lifts.
num_trails_slopes_open Int # of trails/runs open out of number_runs.
number_runs Integer Number of runs.
open_flag String Open | Closed | Temporarily Closed
open_flag_id Int numerical representation of open_flag.
percent_lifts_open Int Percentage of lifts open 0-100.
profile URL Optional Link to the resort profile.
reported_snow_fall Int inches | cm Snow fall in past 24 hours.
reported_snow_fall_48 Int inches | cm Snow fall in past 48 hours.
reported_snow_fall_72 Int inches | cm Snow fall in past 72 hours.
resortCam Cam A cam which is less than 24 hours old.
resortWeather Weather A resort weather object.
reviews URL Optional Link to the resort reviews.
seasonpasses URL Optional Link to the resort season passes page.
skier_email String E-mail
snow_date Date The date and time the snow report was created.
snow_park_reshaped_dt
snow_pipes_recult_dt Date Only available if has_terrain_park=y KM Skategroomed
surface_primary String The primary surface conditions.
terrain_num_features Integer Only available if has_terrain_park=y Number of Features in terrain park.
top_depth Int inches | cm Snow depth at top.
trailmap URL Optional Link to the resort trailmap.
travel URL Optional Link to the resort travel page.
tubing_lanes_open Intger Only available if has_tubing=y # of tubing lanes that are open.
tubing_lift_driven Integer [y|n] Tubing is lift driven.
tubing_total_lanes Integer Number of Tubing lanes.
weather URL Optional Link to the resort weather.
website String Empty Resort Website.

ResortSnowReportWeb

Objects | Methods | _top
@type
base_depth Int inches | cm Snow depth at base.
call_ahead_phone Integer Call Ahead phone
cams URL Optional Link to the resort cams.
has_nordic Char [y|n] Has nordic.
has_skiing Char [y|n] Has skiing.
has_terrain_park Char [y|n] Has terrain park.
has_tubing Char [y|n] Has tubing.
id integer the resort_id for the resort.
lifts_open Int # of lift open out of num_lifts.
lifttickets URL Optional Link to the resort lift tickets.
name String Resort's name.
news URL Optional Link to the resort news.
num_lifts Int Total number of lifts.
num_trails_slopes_open Int # of trails/runs open out of number_runs.
number_runs Integer Number of runs.
open_flag String Open | Closed | Temporarily Closed
open_flag_id Int numerical representation of open_flag.
percent_lifts_open Int Percentage of lifts open 0-100.
profile URL Optional Link to the resort profile.
reported_snow_fall Int inches | cm Snow fall in past 24 hours.
reported_snow_fall_48 Int inches | cm Snow fall in past 48 hours.
reported_snow_fall_72 Int inches | cm Snow fall in past 72 hours.
resortCam Object A cam which is less than 24 hours old.
resortWeather Object A resort weather object.
reviews URL Optional Link to the resort reviews.
seasonpasses URL Optional Link to the resort season passes page.
skier_email String E-mail
snow_date Date The date and time the snow report was created.
snow_park_reshaped_dt
snow_pipes_recult_dt Date Only available if has_terrain_park=y KM Skategroomed
surface_primary String The primary surface conditions.
terrain_num_features Integer Only available if has_terrain_park=y Number of Features in terrain park.
top_depth Int inches | cm Snow depth at top.
trailmap URL Optional Link to the resort trailmap.
travel URL Optional Link to the resort travel page.
tubing_lanes_open Intger Only available if has_tubing=y # of tubing lanes that are open.
tubing_lift_driven Integer [y|n] Tubing is lift driven.
tubing_total_lanes Integer Number of Tubing lanes.
weather URL Optional Link to the resort weather.
website String Empty Resort Website.
x_ctry_kilometers Integer Only available if has_nordic=y KM of Nordic Open
x_ctry_kilometers_total Integer Only available if has_nordic=y KM of Nordic Total
xc_skate_groomed Integer Only available if has_nordic=y KM Skategroomed
xc_trackset Integer Only available if has_nordic=y KM Trackset
xc_trails Integer Only available if has_nordic=y KM of Trails

ResortUpdateRecord

Objects | Methods | _top
@type
id integer the resort_id for the resort.
latitude Double Optional Latitude
longitude Double Optional Longitude
name String Resort's name.
physical_address String Address
physical_city String City
profile_updated Date The last date and time the resort ResortInfo object was last updated.
snow_updated Date The last date and time the SnowReport object was updated. report was created.

State

Objects | Methods | _top
@type
abbrev String State abbrev
id Int the state id .
name String State name.

Story

Objects | Methods | _top
@type
description
id Int the news id .
link URL the link to the full story.
pubdate Date the published date.
title Int the title.

Weather

Objects | Methods | _top
@type
conditions String current weather condition
conditions_icon String current weather icon
date_epoch Int forecast date epoch format
date_long String forecast date long format
dewpoint_c Int dewpoint (c)
dewpoint_f Int dewpoint (f)
forecasts Forecast Forecast Object
pressure_hpa Float airpressure (hpa)
pressure_in Float airpressure (in)
projected_snow_cm Int projected snow fall total (inches)
projected_snow_in Int projected snow fall total (cm)
reporting_country String reporting station country
reporting_state String reporting station state
resporting_city String reporting station city
temp_c Int current temp (c)
temp_f Int current temp (f)
visibility_km Float current visibility (km)
visibility_mi Float current visibility (mi)
wind_direction
wind_kmh
wind_mph
windgust_kmh Int wingusts (kmph)
windgust_mph Int wingusts (mph)