Migration of the endpoint POST /v0/proposals/search/best to POST /v1/proposals/search/best

  • Outdated
  • December 5, 2025
  • 1 related route

Context

Upgrade from POST - ​/v0/proposals/search/best to POST - ​POST /v1/proposals/search/best

1 Key benefit :

  • Uniformize the output with the global proposal model

Impacts

Route to call :

  • POST - ​POST /v1/proposals/search/best

Output

{
  "id": "123456",
+ "product_id": "MPAC",
+ "package_id": "PAI",
  "booking_id": 123456,
  "label": "Proposal with one club room",
+ "resort_arrival_date": "20100430",
+ "resort_departure_date": "20100430",
+ "duration": 7,
+ "accommodations": [
+   {
+     "id": "C",
+     "quantity": 1,
+     "shared_room": false,
+     "link": {
+       "rel": "self",
+       "method": "GET",
+       "href": "https://api.clubmed.com/products",
+       "label": "A label"
+     },
+     "_links": [
+       {
+         "rel": "self",
+         "method": "GET",
+         "href": "https://api.clubmed.com/products",
+         "label": "A label"
+       }
+     ]
+   }
+ ],
+ "remaining_stock": 2,
- "stay": {
-   "product_id": "MPAC",
-   "package_id": "PAI",
-   "arrival_date": "20100430",
-   "leaving_date": "20100430",
-   "duration": 7,
-   "remaining_stock": 2,
-   "accommodations": [
-     {
-       "id": "C",
-       "quantity": 1,
-       "shared_room": false,
-       "link": {
-         "rel": "self",
-         "method": "GET",
-         "href": "https://api.clubmed.com/products",
-         "label": "A label"
-       },
-       "_links": [
-         {
-           "rel": "self",
-           "method": "GET",
-           "href": "https://api.clubmed.com/products",
-           "label": "A label"
-         }
-       ]
-     }
-   ]
- },
  "price": {
    "total": 9815.4,
    "total_without_discount": 10015.4,
    "trip": {
      "initial_price": 10000.15,
      "initial_price_with_fees": 10015.4,
      "fees": [
        {
          "type": "SUBSCRIPTION",
          "amount": 120
        }
      ]
    },
    "included_services": [
      {
        "id": "PVASKH",
        "amount": 200,
        "link": {
          "rel": "self",
          "method": "GET",
          "href": "https://api.clubmed.com/products",
          "label": "A label"
        },
        "_links": [
          {
            "rel": "self",
            "method": "GET",
            "href": "https://api.clubmed.com/products",
            "label": "A label"
          }
        ]
      }
    ],
    "package_options": [
      {
        "type": "CHILDCARE",
        "amount": 152.25,
        "amount_without_discount": 200
      }
    ],
    "total_without_fees": 9775.4,
    "currency": "EUR",
    "total_without_transport": 9005.4,
    "yield_pricing_variation": 50.5,
    "discounts": [
      {
        "type": "OFFER",
        "amount": 200,
        "code": "FRFAM",
-       "id": "TFO",
+       "offer_id": "TFO",
        "service_id": "PVASKH",
        "_links": [
          {
            "rel": "self",
            "method": "GET",
            "href": "https://api.clubmed.com/products",
            "label": "A label"
          }
        ]
      }
    ],
    "is_transfer_included": true
  },
  "option_available": true,
  "option_durability": {
    "expiration_date_time": "20160415T10:23:00.234Z",
    "is_reliable": true
  },
  "households": [
    {
      "attendees": [
        {
          "id": "A",
          "birthdate": "20100430",
          "customer_id": "string",
          "customer_type": "NEW_CUSTOMER"
        }
      ]
    }
  ],
  "locale": "en-US",
  "_links": [
    {
      "rel": "self",
      "method": "GET",
      "href": "https://api.clubmed.com/products",
      "label": "A label"
    }
  ],
  "transportation_summary": [
    {
      "way": "INBOUND",
      "departure_city": "Paris",
      "arrival_city": "Denpensar",
      "transportation_type": "PLANE",
      "cancellation_policy_type": "THEO",
      "is_transfer_included": true,
      "clubmed_transport": false,
      "departure_date": "20100430",
+     "arrival_date": "20100430"
    }
  ],
  "extend_persistence": false,
  "auto_optionable_status": "NONE",
  "is_bookable": false,
+ "creation_date_time": "20100430",
  "vendor": {
    "salesman_id": "00255747"
  },
+ "alternative_price": {
+   "total": 9815.4,
+   "total_without_discount": 10015.4,
+   "discounts": [
+     {
+       "type": "OFFER",
+       "amount": 200,
+       "offer_id": "TFO",
+       "service_id": "PVASKH",
+       "code": "FRFAM",
+       "_links": [
+         {
+           "rel": "self",
+           "method": "GET",
+           "href": "https://api.clubmed.com/products",
+          "label": "A label"
+        }
+      ]
+    }
+   ],
+   "trip": {
+     "initial_price": 10000.15,
+     "initial_price_with_fees": 10015.4,
+     "fees": [
+       {
+         "type": "SUBSCRIPTION",
+         "amount": 120
+       }
+     ]
+   },
+   "included_services": [
+     {
+       "id": "PVASKH",
+       "amount": 200,
+       "link": {
+         "rel": "self",
+         "method": "GET",
+         "href": "https://api.clubmed.com/products",
+         "label": "A label"
+       },
+       "_links": [
+         {
+           "rel": "self",
+           "method": "GET",
+           "href": "https://api.clubmed.com/products",
+           "label": "A label"
+         }
+       ]
+     }
+   ],
+   "package_options": [
+     {
+       "type": "CHILDCARE",
+       "amount": 152.25,
+       "amount_without_discount": 200
+     }
+   ],
+   "total_without_fees": 9775.4,
+   "currency": "EUR",
+   "total_without_transport": 9005.4,
+   "yield_pricing_variation": 50.5
+ },
}