Browse Club Med offers

  • Shopping
  • 2 routes
How can I retrieve the list of Club Med offers and inspect one in detail?

This scenario explains how to list the available Club Med commercial offers and then inspect one offer in detail to expose its editorial content and associated products. It fits marketing, shopping, and promotional-display journeys.

The flow starts from the offer list and then reuses one offer_id to retrieve the selected offer in detail.

Overview

This scenario helps an interface expose Club Med promotional offers and deepen the content of one selected offer.

Prerequisites

  • An accept-language header matching the target market.
  • A valid x-api-key.
  • An offer_id returned by the first step to inspect one offer in detail.

Expected result

The application can display the available offers and then load one offer with its marketing arguments, associated products, and pricing context.

Process workflow

Legend:
Mandatory
Optional
1

List the available offers

Mandatory

Use GET/v1/offers to retrieve the commercial offers exposed for the current locale before selecting one to display in detail.

Prerequisites

  • Send accept-language and x-api-key.
  • Add a filter only if you want to reduce the returned offer list.
  • Reuse the same locale as the rest of the commercial journey.

Calling CURL

curl -X 'GET' \
  'https://api.clubmed.com/v1/offers' \
  -H 'accept: application/json' \
  -H 'accept-language: en-US' \
  -H 'x-api-key: YOUR_API_KEY'

Example answer

[
  {
    "id": "TFO",
    "label": "Family offer",
    "short_label": "Family",
    "seo_label": "family-offer",
    "type": "PROMOTION",
    "color": "#FF6600"
  }
]

info: Reuse the returned offer_id to open the detailed content of the selected offer in the next step.

Response codes

  • OK Response (200): returns the list of offers available for the current locale.
  • Error (400): the request or the submitted filter is invalid.
  • Error (401): non documented in Swagger.
  • Error (404): non documented in Swagger.
GET/v1/offers
See more
2

Retrieve an offer detail

Mandatory

Use GET/v1/offers/{offer_id} to retrieve the detailed content of one commercial offer after selecting it from the list.

Prerequisites

  • Reuse a valid offer_id.
  • Send accept-language and x-api-key.
  • Keep the same locale as the listing step so labels and SEO fields stay aligned.

Calling CURL

curl -X 'GET' \
  'https://api.clubmed.com/v1/offers/TFO' \
  -H 'accept: application/json' \
  -H 'accept-language: en-US' \
  -H 'x-api-key: YOUR_API_KEY'

Example answer

{
  "id": "TFO",
  "label": "Family offer",
  "description": "Special conditions for family bookings",
  "terms_and_conditions": "Offer valid on selected departures",
  "codes": ["FRFAM"],
  "products": [
    {
      "id": "ALHC_WINTER",
      "label": "ALPES HUEZ"
    }
  ]
}

info: The detailed offer payload helps you expose marketing copy, eligible products, and the commercial code used downstream in search or pricing flows.

Response codes

  • OK Response (200): returns the full detail of the selected offer.
  • Error (400): the request is invalid or the provided offer_id is malformed.
  • Error (401): non documented in Swagger.
  • Error (404): non documented in Swagger.
GET/v1/offers/{offer_id}
See more