Discover

Use Club Med API to create your application

The Club Med API is designed to allow partners and integrators to connect directly to Club Med's digital services — whether to search for stays, manage commercial proposals, make reservations, or access customer account data.

Overview

The Club Med API is a modern RESTful platform that exposes the main resources used by Club Med's internal and external systems. It allows you to create, read, update, and delete data related to stays and commercial operations.

It is organized into versions (v0, v2, v3, etc.), where each version brings improvements, additional routes, and enriched integrations. For example, v3 introduces performance optimizations for searching for proposals.

Main objectives

The API was designed to:

  • Connect third-party systems (websites, partner agencies, CRM tools, mobile applications)
  • Automate business flows (offer search, quote generation, service personalization)
  • Centralize the management of customer and stay data in a secure ecosystem
  • Guarantee the consistency of digital experiences across different channels

Key functional areas

The API routes are grouped into several main areas:

Proposals (Stay Proposals)

  • Create and search for commercial proposals
  • Manage participants, dates, and room types

Bookings (Reservations)

  • Transform a proposal into a real reservation
  • Add or modify services and options (transport, transfer, childcare)

Additional services

  • Query the list of services available in a Resort
  • Assign extras to stays

Accounts & Authentication

  • Connect customer accounts
  • Retrieve or update profile information

Resorts & Offers

  • Explore the available Resorts with their characteristics
  • Filter by destination, season, or availability

Security and openness

The API relies on secure authentication via OAuth2 tokens. Exchanges are encrypted in HTTPS. Each integrator receives sandbox and production environment identifiers, facilitating testing and deployments.

Typical integration

A typical integration involves the following steps:

  1. Partner authentication
  2. Stay search via /v3/proposals/search
  3. Selection and adjustment of services via /v0/additional_services
  4. Adding participants and validating the reservation via /v3/bookings

An API scenario typically contains 5 to 8 routes covering the complete traveler cycle, from search to confirmation.

Continuous evolution

The Club Med team regularly publishes release notes, allowing you to follow:

  • New routes and parameters
  • Deprecations
  • Performance optimizations
  • New integrations (TripAdvisor, childcare, etc.)