---
uuid: 6b413c62-ebc9-4128-b74e-ab97e4deebe5
date_created: 2026-01-28T10:39:02.894Z
date_updated: 2026-04-03T17:04:01.745Z
seo_url: retrieve-accommodations-for-a-product
category: Resort content
tags: 
  - Rooms
  - Accommodations
  - Product information
routes: 
  - GET /v2/products/{product_id}/accommodations
---

# Retrieve accommodations for a product

This scenario explains how to retrieve the accommodation catalogue exposed for one Club Med product. It is useful to display rooms, accommodation variants, or product-level lodging information before continuing a proposal or booking journey.

## Flow

false

## Overview

Use `GET /v2/products/{product_id}/accommodations` to read the accommodation inventory available for a given product. This route is typically used upstream of a shopping, proposal, or booking flow.

## Prerequisites

* `product_id` must be known.
* `accept-language` and `x-api-key` headers are required.
* Additional filtering options are not fully visible in the available source material.

## 1 - Retrieve product accommodations

Use `GET /v2/products/{product_id}/accommodations` to retrieve the list of accommodations exposed for a product, together with the metadata needed to display, filter and compare room types.

#### Prerequisites

* Header `accept-language`
* Header `x-api-key`
* Path `product_id`
* Optional query `stay_date`
* Optional query `filter`
* Optional query `sort`
* Optional query `date_format`

#### Calling CURL

```bash
curl --get "https://api.clubmed.com/v2/products/MPAC/accommodations" \
  -H "accept-language: en-US" \
  -H "x-api-key: <your-api-key>" \
  --data-urlencode "stay_date=20100430" \
  --data-urlencode "date_format=ISO"
```

#### Example answer

```json
[
  {
    "id": "A2",
    "label": "Club room",
    "comfort_type": {
      "id": "comfort_type_club",
      "label": "Club"
    },
    "capacity": {
      "min": 1,
      "max": 4
    },
    "area": {
      "min": 39,
      "max": 39,
      "unit": "m²"
    },
    "services": [
      {
        "id": "MST_ACT_SERLGT_000311",
        "label": "Bottle of water"
      }
    ],
    "restriction_information": [
      {
        "id": "restriction01",
        "description": "Certain Room types may be temporarily unavailable due to reduced Resort capacity."
      }
    ]
  }
]
```

> **info:** The response mixes descriptive, operational and merchandising fields. Use `capacity`, `comfort_type`, `services`, `images` and restriction fields to drive both faceting and room-detail pages.

***

**Response codes**

* `200`: accommodations returned successfully.
* `400`: bad request or validation error.
* `403`: forbidden.
* `404`: unknown product.

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