Shopping Calendar for a Specific Product

  • Product Information
  • Shopping calendar
  • 1 route
How to plan your stay using the product calendar?

As a traveler or travel agent, I want to consult a specific product's calendar in order to optimally plan my stay's activities and purchases.

This scenario allows consulting a specific product's shopping calendar, including important dates and special events for optimal planning of activities and purchases during the stay.

1

Retrieve Product Calendar

Mandatory

This route returns the product calendar with open dates, availability, and associated pricing.

Prerequisites

The duration parameter is required. You can refine the search with first_date, last_date, birthdates, or number_attendees.

Calling CURL

curl -X GET \
  -H "x-api-key: $API_KEY" \
  -H "accept-language: en-US" \
  "https://api.clubmed.com/v2/products/{product_id}/calendar?duration=7&first_date=2026-07-01&last_date=2026-08-31&number_attendees=2"

Example answer

{
  "months": [
    {
      "month": "2026-07",
      "days": [
        {
          "date": "2026-07-05",
          "availability": "AVAILABLE",
          "price": {
            "amount": 2890,
            "currency": "EUR"
          },
          "terms_and_conditions": []
        }
      ]
    }
  ]
}

info: This calendar view is useful to build a flexible shopping journey before launching a proposal search.


Response codes

  • 200 OK: the calendar is returned.
  • 400 Bad Request: invalid parameters.
  • 401 Unauthorized: missing or invalid access token.
  • 404 Not Found: unknown product.
GET/v2/products/{product_id}/calendar
See more