Browse and inspect Club Med products

  • Product Information
  • Prebooking
  • 2 routes
How do I list Club Med products and inspect one product in detail?

This feature allows users to retrieve the list of available Club Med products and then access the detailed information of a specific product in order to plan a trip.

It generally relies on two steps: • retrieving the list of available products with their main information (destination, category, price, availability, etc.) • requesting the details of a specific product using its identifier (product_id)

The returned information may include: • General product information (title, category, destination) • Resort characteristics (comfort, areas, capacity_max) • Available services (available_services) • Pricing information (price, currency, terms_and_conditions) • Media and descriptive content (media, description_title) • Location information (countries, geographical_area, region)

This workflow allows users to browse available destinations, compare offers, and select a product that matches their travel plans.

Overview

Use this scenario to browse the Club Med product catalog and inspect one product in detail before moving to search, pricing, or booking flows.

Prerequisites

  • Have a valid x-api-key.
  • Send an accept-language aligned with the target market.
  • Keep the selected product_id to request the detailed product payload.

Expected result

The application can list available products, select one resort or cruise product, and reuse its detailed data to feed a product page or a trip-planning experience.

Process workflow

Legend:
Mandatory
Optional
1

List all products

Mandatory

This route lists Club Med catalog products with optional filtering and pagination.

Prerequisites

Use filter, limit, and page to scope the search. The Swagger contract does not require a timestamp on this route.

Calling CURL

curl -X GET \
  -H "x-api-key: $API_KEY" \
  -H "accept-language: en-US" \
  "https://api.clubmed.com/v2/products?limit=20&page=1&filter[type][_eq]=RESORT"

Example answer

[
  {
    "id": "product-1",
    "label": "Club Med Valmorel",
    "country_code": "FR",
    "type": "RESORT"
  }
]

info: Start with this route to collect product identifiers, then call the detail route to enrich the product page.

Response codes

  • 200 OK: the product list is returned.
  • 206 Partial Content: the list is paginated.
  • 400 Bad Request: invalid parameters.
  • 416 Range Not Satisfiable: invalid pagination range.
GET/v2/products
See more
2

Get product details

Mandatory

This route returns the full detail of a Club Med product from its identifier.

Prerequisites

Use the product_id returned by the list step. No additional parameter is required.

Calling CURL

curl -X GET \
  -H "x-api-key: $API_KEY" \
  -H "accept-language: en-US" \
  "https://api.clubmed.com/v2/products/{product_id}"

Example answer

{
  "id": "product-1",
  "label": "Club Med Valmorel",
  "country_code": "FR",
  "type": "RESORT",
  "description": "Family resort in the Alps",
  "pictures": [
    "https://example.com/product.jpg"
  ]
}

info: Use this detailed payload to feed a product page, a PDP, or a richer preview.

Response codes

  • 200 OK: the product detail is returned.
  • 400 Bad Request: invalid parameters.
  • 404 Not Found: unknown product.
GET/v2/products/{product_id}
See more