Browse products and inspect a product detail

How do I list available products and retrieve one product detail?

This scenario covers the catalog consultation journey: list available products first, then retrieve the detailed information of a selected product.

It is useful for discovery interfaces, search results, and product pages shown before booking.

Overview

The journey starts by retrieving the product catalog, then uses a product_id to load the detailed product sheet.

No functional prerequisite is required to list products.
Keep the product_id returned by the listing step to request the detailed view.

Legend:

Mandatory

Optional

Mandatory

Use GET/v2/products to list available products.

Prepare the parameters required by the call. Keep x-api-key and, when the route is customer-scoped, a valid bearer token.

curl -X GET \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: en-US" \
  "https://api.clubmed.com/v2/products?limit=20&page=1"

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

info: Select a product_id from this list before calling the product detail route.

Response codes

GET/v2/products

Mandatory

Use GET/v2/products/{product_id} to retrieve a product detail.

Prepare product_id. Keep x-api-key and, when the route is customer-scoped, a valid bearer token.

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

{
  "id": "product-1",
  "label": "Club Med Valmorel",
  "country_code": "FR",
  "type": "RESORT",
  "description": "Family resort in the Alps"
}

info: Reuse this response to enrich the product page with detailed content, services, and location data.

Response codes

GET/v2/products/{product_id}