---
uuid: 8778f730-adc2-4e68-8e55-d3eb4618253e
date_created: 2025-07-05T08:07:46.573Z
date_updated: 2026-03-11T09:25:53.710Z
outdated: true
end_of_support_date: 2023-06-05
routes: 
  - GET /v0/offers/{offer_id}
---

# Impact migration of the route GET /v0/offers/{offer\_id}

## Context

Upgrade from `GET /v0/offers/{offer_id}` to \*\* GET\*\* -  `GET /v1/offers/{offer_id}`

⭐  **Key benefits :** Get a standardized ressource
ℹ️ This ressource's structure is based on `/calendar` and `/Search_price ressources`
------------------------------------------------------------------------------------

> As a Shopping dev
> I want to get a standardized price's bloc
> In order to integrate it easily in the shopping views

***

## Impacts

Route to call :

`GET /v1/offers/{offer_id}`

```diff
{
    "id": "EBB",
    "label": "Early Booking Rate",
    "seo_label": "early booking rates",
    "short_label": "Early Booking Rates ",
    "description": "Be an early booker and **save up to 50% OFF** on your Summer & Winter 2022 vacations-eserve your spot today for the lowest price. **Book by July 30th, 2022 travel between February 18, 2022 to June 30, 2023.**",
    "seo_description": "The earlier you book, the best your rate is going to be. Take advantage of Club Med all inclusive booking deals and plan your 2022 vacation ahead.",
    "image": "https://zupimages.net/up/22/11/6wtd.jpg",
    "commercial_argument": "Up to 50% OFF",
    "timing_argument": "Early Booking Rate",
    "legal_information": "To see our Flexible Cancellations Conditions, ",
    "color": "#C39614",
    "products": [
      {
!        "product_id": "CANC",
        "price": {
          "currency": "EUR",
-          "initial_price":
-          {
-              "per_adult_per_trip": 975,
-              "per_adult_per_trip_with_fees": 1002.5,
-              "per_adult_per_night": 140,
-              "per_adult_per_night_with_fees": 144,
-              "per_trip": 975,
-              "per_trip_with_fees": 1002.5,
-              "per_night": 140,
-              "per_night_with_fees": 144
-          },
-          "best_price":
-          {
-              "per_adult_per_trip": 824,
-              "per_adult_per_trip_with_fees": 851.5,
-              "per_adult_per_night": 118,
-              "per_adult_per_night_with_fees": 122,
-              "per_trip": 824,
-              "per_trip_with_fees": 851.5,
-              "per_night": 118,
-              "per_night_with_fees": 122
-          },
-          "fee":
-          {
-              "per_adult_per_trip": 27.5,
-              "per_adult_per_night": 4,
-              "per_trip": 27.5,
-              "per_night": 4
-          },
+          "per_trip": {
+            "fees_amount": 60,
+            "initial_price": 2460.01,
+            "best_price": 1230.01
+          },
+          "per_night": {
+            "fees_amount": 9,
+            "initial_price": 352,
+            "best_price": 176
+          }
        },
        "terms_and_conditions": {
-          "price_per": "ADULT",
-          "package": "ALL_INCLUSIVE",
-          "departure_date": "2023-08-26",
-          "arrival_date": "2023-08-26",
-          "duration": 7,
-          "total_duration": 7,
-          "number_of_rooms_available_for_this_comfort": 14,
-          "number_of_adults": 2,
-          "accommodation_id": "C",
-          "accommodation_comfort_label": "Superior Room - Ground Level"
+          "occupancy_rate": 22.89,
+          "departure_city": {
+            "id": "PAR",
+            "label": "Paris"
+          },
+          "departure_location": {
+            "id": "CDG",
+            "label": "Charles de Gaulle airport"
+          },
+          "accommodations": [
+            {
+              "id": "C2",
+              "label": "",
+              "_links": [
+                {
+                  "rel": "accommodation_detail_v2",
+                  "method": "GET",
+                  "href": "https://api.staging.clubmed.com/v2/products/GMAC_WINTER/accommodations/C2"
+                }
+              ]
+            }
+          ],
+          "package": "AI",
+          "departure_date": "20230409",
+          "arrival_date": "20230409",
+          "duration": 7,
+          "transport_duration_in_min": null,
+          "total_duration": 7,
+          "adults_count": 2,
+          "children_count": 0,
+          "flights_connection_count": {
+            "inbound": 1,
+            "outbound": 0
+          },
+          "_links": [
+            {
+              "rel": "package_detail",
+              "method": "GET",
+              "href": "https://api.staging.clubmed.com/v0/products/GMAC_WINTER/packages/AI"
            }
          ]
        },
+       "_links": [
+         {
+              "rel": "product_detail",
+              "method": "GET",
+              "href": "https://api.staging.clubmed.com/v0/products/GMAC_WINTER/"
          }
      }
    ]
  }
```

**Model**

| Champ API                                                  | O/F | nullable | Type   | Description                                          | Example                          |
| ---------------------------------------------------------- | --- | -------- | ------ | ---------------------------------------------------- | -------------------------------- |
| price.currency                                             | O   |          | string | Indicates the currency                               | EUR                              |
| price.per\_trip.fees\_amount                               | O   |          | number | Indicates the fee amount                             | 0                                |
| price.per\_trip.initial\_price                             | O   |          | number | Indicates the initial trip price                     | 0                                |
| price.per\_trip.best\_price                                | O   |          | number | ndicates the best trip price                         | 0                                |
| price.per\_night.fees\_amount                              | O   |          | number | Indicates the fee amount                             | 0                                |
| price.per\_night.initial\_price                            | O   |          | number | Indicates the initial night price                    | 0                                |
| price.per\_night.best\_price                               | O   |          | number | Indicates the best night price                       | 0                                |
| terms\_and\_conditions.occupancy\_rate                     | O   |          | ENUM   | rate of occupancy of the product                     | 0                                |
| terms\_and\_conditions.package                             | O   |          | ENUM?  | Package code                                         | AI                               |
| terms\_and\_conditions.departure\_city                     | O   | Yes      |        |                                                      |                                  |
| terms\_and\_conditions.departure\_city.id                  | N   |          | string | Departure city's id                                  | PAR                              |
| terms\_and\_conditions.departure\_city.label               | N   |          | string | Departure city's label                               | Paris                            |
| terms\_and\_conditions.departure\_location                 | O   | Yes      |        |                                                      |                                  |
| terms\_and\_conditions.departure\_location.id              | N   |          | string | Departure location's id                              | CDG                              |
| terms\_and\_conditions.departure\_location.label           | N   |          | sring  | Departure location's label                           | Charles de Gaulles Airport       |
| terms\_and\_conditions.accommodations.id                   | O   |          | string | Accommodation's id                                   | C3                               |
| terms\_and\_conditions.accommodations.label                | O   |          | string | Accommodation's label                                | Chambre Club                     |
| terms\_and\_conditions.accommodations.\_links.method       | O   |          | ENUM   | Accommodation additional infomration's method        | GET                              |
| terms\_and\_conditions.accommodations.\_links.href         | O   |          | string | Accommodation additionnal information's link         | api.clubmed.com/v1/products/AGAC |
| terms\_and\_conditions.accommodations.\_links.rel          | O   |          | string | Accommodation additional information's relation link | product\_detail                  |
| terms\_and\_conditions.departure\_date                     | O   |          | string | Departure date (YYYYMMDD format)                     | 20230101                         |
| terms\_and\_conditions.arrival\_date                       | O   |          | string | Arrival date (YYYYMMDD format)                       | 20230101                         |
| terms\_and\_conditions.duration                            | O   |          | number | Stay's duration                                      | 7                                |
| terms\_and\_conditions.transport\_duration\_in\_min        | O   | null     | number | Indicates the transport duration in min              | 747                              |
| terms\_and\_conditions.total\_duration                     | O   |          | number | Total booking duration                               | 7                                |
| terms\_and\_conditions.adults\_count                       | O   |          | number | Indicates the number of adults                       | 1                                |
| terms\_and\_conditions.children\_count                     | O   |          | number | Indicates the number of children                     | 0                                |
| terms\_and\_conditions.flights\_connection\_count          | O   | Yes      |        |                                                      |                                  |
| terms\_and\_conditions.flights\_connection\_count.inbound  | N   |          | number | Number of inbound flight's connection                | 1                                |
| terms\_and\_conditions.flights\_connection\_count.outbound | N   |          | number | Number of outbound flight's connection               | 1                                |
| terms\_and\_conditions.\_links.method                      | O   |          | ENUM   | Additional infomration's method                      | GET                              |
| terms\_and\_conditions.\_links.href                        | O   |          | string | Additionnal information's link                       | api.clubmed.com/v1/products/AGAC |
| terms\_and\_conditions.\_links.rel                         | O   |          | string | Additional information's relation link               | product\_detail                  |
| \_links.method                                             | O   |          | ENUM   | Additional infomration's method                      | GET                              |
| \_links.href                                               | O   |          | string | Additionnal information's link                       | api.clubmed.com/v1/products/AGAC |
| \_links.rel                                                | O   |          | string | Additional information's relation link               | product\_detail                  |

## Specific evolutions

***

### New values form

| Champ                                 | Ancienne valeur ❌ | Nouvelle valeur ✅ |
| ------------------------------------- | ----------------- | ----------------- |
| `terms_and_conditions.package`        | `ALL_INCLUSIVE`   | `AI`              |
| `terms_and_conditions.departure_date` | `2023-01-01`      | `20230101`        |
| `terms_and_conditions.arrival_date`   | `2023-01-01`      | `20230101`        |

### New parameter name

> 💡 `prodcuts.id` becomes `products.product_id`
