Retrieve accommodations for a product

  • Rooms
  • Resort content
  • 1 route
How do I retrieve the accommodations available for a Club Med 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.

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

Mandatory

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

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

[
  {
    "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.
GET/v2/products/{product_id}/accommodations
See more