Retrieve a resort's yearly weather averages

  • Product Information
  • Resort content
  • 1 route
How can I retrieve a resort's monthly weather averages over a full year?

Use this scenario to display a resort's typical weather conditions month by month. It helps enrich a product page, a destination guide, or an inspiration experience with average temperatures and snow levels when relevant.

The route returns one entry per month for the selected resort, which makes it easy to build a compact climate widget or a more detailed yearly weather section.

Overview

This scenario documents how to retrieve the monthly average weather for a resort with a single API call. The response provides typical minimum and maximum temperatures for each month and, when relevant, snow information that can be reused in editorial or product experiences.

Prerequisites

  • A valid product_id for the resort
  • A valid x-api-key
  • An accept-language header matching one of the supported locales

Expected result

At the end of this scenario, you can display a yearly weather overview for the selected resort and reuse the monthly values in a product page, a seasonal guide, or a destination information block.

1

Retrieve monthly weather averages

Mandatory

This route returns the monthly average weather for a resort. It is useful when you want to display a twelve-month climate overview based on the resort product_id.

Prerequisites

  • A valid product_id, for example MPAC
  • A valid x-api-key
  • An accept-language header, for example en-US

Calling CURL

curl -X GET \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: en-US" \
  "https://api.clubmed.com/v0/products/MPAC/monthly_weather"

Example answer

[
  {
    "month": "1",
    "temp_min_C": 12,
    "temp_max_C": 24,
    "temp_min_F": 53.6,
    "temp_max_F": 75.2,
    "snow_level_in_cm": 90,
    "snow_level_in_inches": 35.4
  }
]

info: The response contains one entry per month. You can reuse it directly to build a yearly weather widget, a seasonality table, or a destination information block.


Response codes

  • 200 OK: the resort monthly average weather is returned
  • 400 Bad Request: a required parameter is missing or invalid
  • 403 Forbidden: the request is not allowed for this API key
  • 404 Not Found: the product_id does not match any known resort
GET/v0/products/{product_id}/monthly_weather
See more