# Mountain News Partner API

The Mountain News Snow & Weather Report API provides real-time weather and operating data for ski resorts throughout the world. It is a fee-based service designed for media companies, governments, and financial institutions that wish to use the data for external or internal purposes. 

### Getting access

To learn more about licensing the data please [contact](https://www.mountainnews.com/#contact) our sales team with your use case.

### Authentication

Upon being granted access to the API, you will be provided a key to access the Mountain News API. The api uses **API key-based authentication,** to request an api resource simply append `x-api-key` to your http header requests with the api key provided. 

***Example curl request***

```
curl -X GET "https://partner-api.onthesnow.com/resort/482/snowreport" \
     -H "x-api-key: your-api-key-value" \
     -H "Content-Type: application/json"

```

### API Resource

The Partners API is a RESTful JSON API. For complete details on the available resources and response formats, refer to the [API reference](#api-resource). The primary resources provided by the API include:

* [**Resorts**](https://partner.docs.onthesnow.com/broken-reference)**:** This endpoint is used to filter resorts to a particular region, then use the resort ids to subsequently return snow and weather data.
* [**Resort / Snowreport**](https://partner.docs.onthesnow.com/broken-reference): Snow conditions, trail statuses, lift statuses, and other key operational details.
* [**Resort / Weather**:](https://partner.docs.onthesnow.com/broken-reference) Provides daily and hourly weather forecasts for a ski resort.
* [**Resort / Webcams**](https://partner.docs.onthesnow.com/broken-reference): Grants access to live ski resort webcams with daily updates.
* [**Resort / Profile**](https://partner.docs.onthesnow.com/broken-reference): Delivers profile information for a ski resort, including its location and other useful details.