---
uuid: 3b3c7ad7-2b90-4a6f-8f63-5cf9d3328c63
date_created: 2025-12-08T15:50:19.062Z
date_updated: 2026-04-02T15:00:11.134Z
seo_url: shopping-calendar-for-a-specific-product
category: Shopping calendar
tags: 
  - Product Information
routes: 
  - GET /v2/products/{product_id}/calendar
---

# Shopping Calendar for a Specific Product

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.

## Flow

false

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

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

```bash
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

```json
{
  "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.

**Related route**: [GET https://api.clubmed.com//v2/products/{product\_id}/calendar](https://api.clubmed.com/doc?search=GET%20%2Fv2%2Fproducts%2F%7Bproduct_id%7D%2Fcalendar)